AIS V3.4 Protocol Reference V2

Configuring and Monitoring APPN

This chapter describes the APPN configuration and monitoring commands. It includes the following sections:

• "APPN Configuration Command Summary"
• "APPN Configuration Command Detail"
• "APPN Dynamic Reconfiguration Support"

Accessing the APPN Configuration Process

Use the following procedure to access the APPN configuration process.

1. At the * prompt, enter talk 6. The Config> prompt is displayed.

   (If this prompt is not displayed, press Return again.)

2. Enter protocol appn. The APPN Config> prompt is displayed.
3. Enter an APPN configuration command.

APPN Configuration Command Summary

Table 4. APPN Configuration Command Summary

Command	Function	See page:
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Enable/Disable	Enables/disables the following:	"Enable/Disable"
	APPN
	Dependent LU Requestor
	Port port name
Set	Sets the following:
	Node	Table 5
	Traces	Table 10
	HPR	Table 6
	DLUR	Table 8
	Management	Table 16
	Tuning	Table 9
Add	Adds or updates the following:
	Port port name	Table 18
	Link-station link station name	Table 23
	LU-Name LU name	Table 28
	Connection-network connection network name	Connection Network - Detail
	Additional-port-to-connection-network	Table 32
	Mode	Table 31
	Focal_point	Table 33
	local-pu	Table 34
	Routing_list	Table 35
	COS_mapping_table	Table 36
Delete	Deletes the following:  Port port name Link-station link station name LU-Name LU name Connection-network connection network name Connection networks port interface (CN PORTIF) CN name Mode mode name Focal_point local-pu Routing_list COS_mapping_table	"Delete"
List	Lists the following from configuration memory:  All Node Traces Management HPR DLUR Port port name Link-station link name LU-Name LU name Mode mode name Connection-network connection network name Focal_point Routing_list COS_mapping_table	"List"
Activate_new_config	Reads the configuration into non-volatile configuration memory.	"Activate_new_config"
TN3270	Accesses the TN320E config> command prompt	"TN3270E"
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

Note:

APPN will respond to a dynamic reset command at the interface level.

APPN Configuration Command Detail

Enable/Disable

Use the enable/disable command to enable (or disable):

Syntax:

enable

appn

[or disable]

dlur

port port name

Set

Use the set command to set:

Syntax:

set

node

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 5. Configuration Parameter List - APPN Routing

Parameter Information
Parameter Enable APPN Valid Values Yes, No Default Value Yes Description This parameter enables or disables the router as an APPN network node. This parameter enables both APPN and HPR routing capability for this network node which consists of defining the Network ID and CP name for this node. APPN, however, must be enabled on the particular ports on which you desire to support APPN routing. Additionally, support for HPR must be enabled on the particular APPN ports desired and must be supported by the particular link stations on those ports. Note: HPR only supported on LAN, Frame Relay and PPP direct DLC ports.
Parameter Network ID (required) Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: A network identifier for an existing network, of which this router network node is to become a member, using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new network IDs. Default Value None Description This parameter specifies the name of the APPN network to which this network node belongs. The network ID must be the same for all network nodes in the APPN network. Attached APPN end nodes and LEN end nodes can have different network IDs.
Parameter Control point name (required) Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing CP name that this node would be acquiring, using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new CP names. Default None Description This parameter specifies the name of the CP for this APPN network node. The CP is responsible for managing the APPN network node and its resources. The CP name is the logical name of the APPN network node in the network. The CP name must be unique within the APPN network identified by the Network ID parameter.
Parameter Enable branch extender or border node Valid Values 0 (enable neither) 1 (enable branch extender) 2 (enable border node) Default 0 Description This parameter specifies whether branch extender function, border node function, or neither will be enabled on this node. If either function is enabled, appropriate additional questions will be asked.
Parameter Enable Branch Awareness Support Valid Values 0 (Full), 1 (Partial), 2 (None) Default 0 (Full) Description This parameter specifies whether you want to limit the flow of topology information regarding Branch Extender topology. Full means that the node will broadcast all Branch Extender TGs into the network when they are learned. Partial means that the node will not broadcast local Branch Extender topology, but will store and broadcast non-local Branch Extender topology. None means that the node will not broadcast local Branch Extender topology and it will ignore any Branch Extender topology received from the network and the node will not store or broadcast non-local Branch Extender topology.
Parameter Permit search for unregistered LUs Valid Values Yes or No Default No Description This parameter specifies whether this node (when acting as an End Node) can be searched for LUs even if the LUs were not registered with the network node server of the Branch Extender. If yes is specified, this node can be searched for LUs. Note: This question is asked only if Enable Branch Extender or Border Node parameter is set to branch extender.
Parameter Subnet visit count Valid Values 1 -- 255 Default 3 Description Specifies the node level default for the maximum number of subnetworks that a multi-subnetwork session may traverse. The default may be overridden as part of port, link, or routing list configuration. Note: This is the first of the questions asked only if border node has been enabled.
Parameter Cache searches for (0-255) minutes Valid Values 0 - 255 Default 8 Description Specifies how many minutes the BN retains information in the multi-subnet search cache once the search terminates.
Parameter Maximum number of searches in cache Valid Values 0 - 32765 (0=unlimited) Default 0 Description Specifies the maximum number of entries in the multi-network search cache. Once this limit is reached, the oldest entries are discarded. Note: The primary mechanism for deletion of these entries is the cache search time value specified in cache searches for (0-255) minutes.
Parameter Dynamic routing list updates Valid Values 0 (none) - No dynamic entries are added. 1 (full) - All native border nodes, all adjacent non-native border and network nodes, and nodes that know of similarly named destination LUs are added. 2 (limited) - All native border nodes, all adjacent non-native border nodes and network nodes with the same NETID, and nodes that know of similarly named destination LUs are added. Default 2 Description Indicates the degree to which, if any, that a BN can supplement configured routing list data with topology data learned by the operational code. This supplemental data is not saved in SRAM.
Parameter Enable routing list optimization Valid Values Yes or No Default Yes Description Indicates whether or not a BN may reorder the operational code's temporary copy of a subnetwork routing list so that entries that are more likely to be successful are found first.
Parameter Load balance across parallel inter-subnet boundaries Valid Values Yes or No Default No Description This parameter specifies whether the router should attempt to balance the number of sessions across two or more parallel inter-subnet exit points when it is functioning as an EBN. The relevant configuration has two or more IBM routers serving as EBN exit points in one subnet, with the same number in the other subnet. Each router has an inter-subnet TG to a different router in the other subnet, forming two or more parallel links. (Note that these are not parallel TGs between any two routers.) To configure session load balancing among the parallel exit points: Set this parameter to yes. Configure routing lists (see ***) in each EBN router, so that sessions for different destination LU names have different preferred exit EBNs. You also configure the preferred inter-subnet boundary and can set backup paths. Configure the routing lists with dynamic routing list updates set to none, and Enable routing list optimization set to no. Note: This is the last of the questions asked only if border node has been enabled.
Parameter Route addition resistance Valid Values 0 to 255 Default Value 128 Description This parameter indicates the desirability of routing through this node. This parameter is used in the class of service based route calculation. Lower values indicate higher levels of desirability.
Parameter XID number for subarea connection (see table notes) Valid Values A string of 5 hexadecimal digits Default X'00000' Description This parameter specifies a unique ID number (identifier) for the network node. The XID number is combined with an ID block number (which identifies a specific product) to form an XID node identification. Node identifications are exchanged between adjacent nodes when the nodes are establishing a connection. The router network node automatically appends an ID block number to this parameter during the XID exchange to create an XID node identification. The ID number you assign to this node must be unique within the APPN network identified by Network ID parameter. Contact your network administrator to verify that the ID number is unique.
Note: Node identifications are normally exchanged between T2.1 nodes during CP-CP session establishment. If the network node is communicating with the IBM Virtual Telecommunications Access Method (VTAM) product through a T2.1 LEN node and the LEN node has a CP name defined for it, the XID number parameter is not required. If the adjacent LEN node is not a T2.1 node or does not have an explicitly defined CP name, the XID number parameter must be specified to establish a connection with the LEN node. VTAM versions prior to Version 3 Release 2 do not allow CP names to be defined for LEN nodes.

Syntax:

set

high-performance routing

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 6. Configuration Parameter List - High-Performance Routing (HPR)

Parameter Information

Parameter Maximum sessions for HPR connections Valid Values 1 to 65 535 Default Value 100 Description This parameter specifies the maximum number of sessions allowed on an HPR connection. An HPR connection is defined by the class of service (COS), the physical path (TGs), and the network connection end points. This parameter is applicable only when the router is the initiator of the BIND. If the number of sessions exceeds the specified value for this parameter, HPR will allocate another HPR (RTP) connection.

Table 7. Configuration Parameter List - HPR Timer and Retry Options

Parameter Information
Low transmission priority traffic
Parameter RTP inactivity timer Valid Values 1 to 3600 seconds Default Value 180 seconds Description This parameter specifies RTP's inactivity interval for HPR connections that carry traffic with low transmission priority. This is an end-to-end version of the LLC inactivity timer, Ti. If no receptions occur during this interval, RTP transmits a poll. Idle periods are monitored to ensure the integrity of the connection.
Parameter Maximum RTP retries Valid Values 0 to 10 Default Value 6 Description This parameter specifies the maximum number of retries before RTP initiates a path switch on an HPR connection that carries traffic with low transmission priority.
Parameter Path switch timer Valid Values 0 to 7200 seconds Default Value 180 seconds Description This parameter specifies the maximum amount of time that a path switch may be attempted on an HPR connection carrying traffic with low transmission priority. A value of zero indicates that the path switch function is to be disabled, and a path switch will not be performed.
Medium transmission priority traffic
Parameter RTP inactivity timer Valid Values 1 to 3600 seconds Default Value 180 seconds Description This parameter specifies RTP's inactivity interval for HPR connections that carry traffic with medium transmission priority. This is an end-to-end version of the LLC inactivity timer, Ti. If no receptions occur during this interval, RTP transmits a poll. Idle periods are monitored to ensure the integrity of the connection.
Parameter Maximum RTP retries Valid Values 0 to 10 Default Value 6 Description This parameter specifies the maximum number of retries before RTP initiates a path switch on an HPR connection that carries traffic with medium transmission priority.
Parameter Path switch timer Valid Values 0 to 7200 seconds Default Value 180 seconds Description This parameter specifies the maximum amount of time that a path switch may be attempted on an HPR connection carrying traffic with medium transmission priority. A value of zero indicates that the path switch function is to be disabled, and a path switch will not be performed.
High transmission priority traffic
Parameter RTP inactivity timer Valid Values 1 to 3600 seconds Default Value 180 seconds Description This parameter specifies RTP's inactivity interval for HPR connections that carry traffic with high transmission priority. This is an end-to-end version of the LLC inactivity timer, Ti. If no receptions occur during this interval, RTP transmits a poll. Idle periods are monitored to ensure the integrity of the connection.
Parameter Maximum RTP retries Valid Values 0 to 10 Default Value 6 Description This parameter specifies the maximum number of retries before RTP initiates a path switch on an HPR connection that carries traffic with high transmission priority.
Parameter Path switch timer Valid Values 0 to 7200 seconds Default Value 180 seconds Description This parameter specifies the maximum amount of time that a path switch may be attempted on an HPR connection carrying traffic with high transmission priority. A value of zero indicates that the path switch function is to be disabled, and a path switch will not be performed.
Network transmission priority traffic
Parameter RTP inactivity timer Valid Values 1 to 3600 seconds Default Value 180 seconds Description This parameter specifies RTP's inactivity interval for HPR connections that carry traffic with network transmission priority. This is an end-to-end version of the LLC inactivity timer, Ti. If no receptions occur during this interval, RTP transmits a poll. Idle periods are monitored to ensure the integrity of the connection.
Parameter Maximum RTP retries Valid Values 0 to 10 Default Value 6 Description This parameter specifies the maximum number of retries before RTP initiates a path switch on an HPR connection that carries traffic with network transmission priority.
Parameter Path switch timer Valid Values 0 to 7200 seconds Default Value 180 seconds Description This parameter specifies the maximum amount of time that a path switch may be attempted on an HPR connection carrying traffic with network transmission priority. A value of zero indicates that the path switch function is to be disabled, and a path switch will not be performed.

Syntax:

set

dlur

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 8. Configuration Parameter List - Dependent LU Requester

Parameter Information
Parameter Enable dependent LU requester (DLUR) on this network node Valid Values Yes, No Default Value No Description This parameter specifies whether a dependent LU requester is to be functionally enabled on this node.
Parameter Default fully-qualified CP name of primary DLUS (required when DLUR is enabled) Valid Values A string of up to 17 characters in the form of netID.CPname, where: netID is a network ID from 1 to 8 characters CPname is a CP name from 1 to 8 characters Each name must conform to the following rules: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing fully-qualified CP name, using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new CP names. Default Value None Description This parameter specifies the fully-qualified control point (CP) name of the dependent LU server (DLUS) that is used by default. The default primary server may be overridden on a link station basis. The default server is used for incoming requests from downstream PUs when a primary DLUS has not been specified for the associated link station.
Parameter Default fully-qualified CP name of backup dependent LU server (DLUS) Valid Values A string of up to 17 characters in the form of netID.CPname, where: netID is a network ID from 1 to 8 characters CPname is a CP name from 1 to 8 characters Each name must conform to the following rules: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing fully-qualified CP name, using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new CP names. Default Value Null Description This parameter specifies the fully-qualified CP name of the dependent LU server (DLUS) that is used as the default backup. A backup is not required, and the null value (representing no entry) indicates the absence of a default backup server. The default backup server may be overridden on a link station basis.
Parameter Perform retries to restore disrupted pipe Valid Values Yes, No Default Value No Description This parameter specifies whether DLUR will attempt to reestablish the pipe to a DLUS after a pipe failure. If DLUR receives a non-disruptive UNBIND and this parameter is No, DLUR waits indefinitely for a DLUS to reestablish the broken pipe. If the pipe fails for any other reason and this parameter is No, DLUR attempts to reach the primary DLUS once. If this is unsuccessful, DLUR attempts to reach the backup DLUS. If this attempt also fails, DLUR waits indefinitely for a DLUS to reestablish the pipe. See "DLUR Retry Algorithm" for a description of the retry algorithm.
Parameter Delay before initiating retries Valid Values 0 to 2 756 000 seconds Default Value 120 seconds Description This parameter specifies an amount of time for two different cases when the pipe between the DLUR and its DLUS is broken. For the case of receiving a non-disruptive UNBIND: This parameter specifies the amount of time the DLUR must wait before attempting to reach the primary DLUS. A value of 0 indicates immediate retry by the DLUR. For all other cases of pipe failure: The DLUR will try the primary DLUS and then the backup DLUS immediately. If this fails, DLUR will wait for the amount of time specified by the minimum of the short retry timer and this parameter before attempting to reach the primary DLUS. See "DLUR Retry Algorithm" for a complete description of the retry algorithm.
Parameter Perform short retries to restore disrupted pipe Valid Values Yes, No Default Value If Perform retries to restore disrupted pipes is Yes, then the default value is Yes. Otherwise, the default is No. Description See "DLUR Retry Algorithm" for a complete description of the retry algorithm.
Parameter Short retry timer Valid Values 0 to 2 756 000 seconds Default Value 120 seconds Description In all cases of pipe failure other than non-disruptive UNBIND, the minimum of Delay before initiating retries and this parameter specifies the amount of time DLUR will wait before attempting to reach the primary DLUS after an attempt to establish this connection has failed. See "DLUR Retry Algorithm" for a complete description of the retry algorithm.
Parameter Short retry count Valid Values 0 to 65 535 Default Value 5 Description In all cases of pipe failure other than non-disruptive UNBIND, this parameter specifies the number of times the DLUR will attempt to perform short retries to reach the DLUS after an attempt to establish this connection has failed. See "DLUR Retry Algorithm" for a complete description of the retry algorithm.
Parameter Perform long retries to restore disrupted pipe Valid Values Yes, No Default Value If Perform retries to restore disrupted pipes is Yes, then the default value is Yes. Otherwise, the default is No Description See "DLUR Retry Algorithm" for a complete description of the retry algorithm.
Parameter Long retry timer Valid Values 0 to 2 756 000 seconds Default Value 300 seconds Description This parameter specifies the time DLUR will wait when performing long retries. See "DLUR Retry Algorithm" for a complete description of the retry algorithm.
Parameter Take down the dependent link when there is no session Valid Values Yes or No Default Value No Description This parameter specifies whether the router should deactivate the link to a dependent PU when the PU is deactivated and there are no active LU-LU sessions on it. Set this parameter to yes if you have an older SNA product that doesn't support receiving ACTPU following a DACTPU, without an intervening link deactivation. Such a product would appear hung after a deactivate/activate sequence.

Syntax:

set

tuning

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Note:

You will have to re-boot in order for the changes you specify to take place.

Table 9. Configuration Parameter List - APPN Node Tuning

Parameter Information
Parameter Maximum number of adjacent nodes Valid Values 1 to 8 000 Default 100 Description This parameter is an estimate of the maximum number of nodes that you expect to be logically adjacent to this router network node at any one time. This parameter is used along with the Maximum number of ISR sessions parameter by the automatic tuning algorithm to calculate the values for the Maximum shared memory and Maximum cached directory entries tuning parameters. This parameter is configurable using the Configuration Program only.
Parameter Maximum number of network nodes sharing the same APPN network id Valid Values 10 to 8 000 Default 50 Description This parameter is an estimate of the maximum number of nodes that you expect in the subnetwork (that is, in the topology known by this node). This parameter is configurable using the Configuration Program only.
Parameter Maximum number of TGs connecting network nodes with the same APPN network id Valid Values 9 to 64 000 Default 3 times the value of the maximum number of network nodes in the subnetwork. Description This parameter is an estimate of the maximum number of TGs connecting network nodes in the subnetwork (that is, in the topology known by this node). This parameter is configurable using the Configuration Program only.
Parameter Maximum number of ISR sessions Valid Values 10 to 60 000 Default Value 200 Description This parameter specifies an estimate of the maximum number of intermediate session routing sessions (ISR) expected to be supported by this router network node at any one time. This parameter is used in conjunction with the Maximum number of adjacent nodes parameter by the automatic tuning algorithm to calculate the values for the Maximum shared memory and Maximum cached directory entries tuning parameters. This parameter is configurable using the Configuration Program only.
Parameter Percent of adjacent nodes with CP-CP sessions using HPR Valid Values 0 to 100% Default Value 0 (none) Description This parameter specifies an estimate of the maximum number of adjacent EN and NN, with CP-CP sessions using option set 1402 (Control Flows over RTP option set). This parameter is configurable using the Configuration Program only.
Parameter Maximum percent of ISR sessions using HPR data connections Valid Values 0 to 100 percent Default 0 percent Description This parameter specifies the largest percentage of ISR sessions that use ISR to HPR mappings. This parameter is configurable using the Configuration Program only.
Parameter Percent adjacent nodes that function as DLUR PU nodes Valid Values 0 to 100 percent Default 0 percent Description This parameter specifies the largest percentage of adjacent nodes allowed to function as adjacent DLUR PU nodes. This parameter is configurable using the Configuration Program only.
Parameter Maximum percent ISR sessions used by DLUR LUs Valid Values 0 to 100 percent Default 0 percent Description This parameter specifies the largest percentage of ISR sessions used by DLUR LUs. This parameter is configurable using the Configuration Program only.
Parameter Maximum number of ISR accounting memory buffers Valid Values 0 or 1 Default Value 0 (default is 1 if ISR session accounting is enabled) Description This parameter specifies a maximum number of buffers to be reserved for ISR session accounting. This parameter is configurable using the Configuration Program only.
Parameter Maximum memory records per ISR accounting buffer Valid Values 0 to 2000 Default Value 100 Description This parameter specifies a maximum number of memory records per ISR accounting buffer. This parameter is configurable using the Configuration Program only.
Parameter Override tuning algorithm Valid Values Yes, No Default Value Yes Description When enabled, this parameter overrides the tuning calculations generated by the tuning input parameters and enables you to specify explicit values for the Maximum shared memory parameter, the percent buffer memory parameter, and the Maximum cached directory entries parameter. This parameter is configurable using the Configuration Program only.
Parameter Number of local-pus for TN3270E support Valid Values Default Value Description This parameter specifies the number of local PUs that are available for TN3270 support. This parameter is configurable using the Configuration Program only.
Parameter Total number of LUs for TN3270E Valid Values Default Value Description This parameter specifies the total number of LUs available for TN3270E support. This parameter is configurable using the Configuration Program only.
Parameter Maximum shared memory Valid Values 0 - 16 777 215 KB Default Value Auto-configured (configure based on installed memory) Description This parameter specifies the amount of shared memory within the router that is allocated to the APPN network node. APPN uses its shared memory allocation to perform network operations and to maintain required tables and directories. You can either input a value in Kilobytes, or select to have the router pick a reasonable general purpose default value at boot time based on its installed memory. Note that the default value the router chooses is not based on the size of the APPN configuration. Default values assume you are running a medium-size APPN or TN3270 network, and some other non-trivial routing function. The default value may not fit if you also configure another extremely memory-intensive router function. As you select the auto-configured value from the command-line prompt, you can see what this value will be if you boot the configuration on the router you are using. If you select this value from the Configuration Program, you must download and activate the configuration before you can see what the result will be. This parameter is configurable using the Configuration Program and from the command line.
Parameter Percent of APPN shared memory to be used for buffers Valid Values 5 to 50 Default 11% or 512 Kilobytes, whichever is larger. Description This parameter specifies the amount of shared memory that APPN will use for buffers. You can allow APPN to have a 4KB RU size by setting maximum shared memory to at least 1 MB, and setting percent of APPN shared memory used for buffers to a sufficiently large value to allow at least 1 MB of memory to be available to the buffer manager. This parameter is configurable using the Configuration Program and from the command line.
Parameter Maximum cached directory entries Valid Values 0 to 65 535 Default 4000 Description This parameter specifies the number of directory entries to be stored or cached by the router network node. If a directory entry for a node is cached, the router does not need to broadcast a search request to locate the node. This reduces the time it takes to initiate sessions with the node. This parameter is configurable using the Configuration Program and from the command line.

Syntax:

set

traces

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 10. Configuration Parameter List - Trace Setup Questions

Parameter Information
Parameter Turn all trace flags off Valid Values Yes, No Default Value No Description This parameter enables or disables trace flags.
Parameter Edit Node-Level Traces Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. See Table 11 for the set of questions you will be asked if this option is enabled.
Parameter Edit Interprocess Signals Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. See Table 12 for the set of questions you will be asked if this option is enabled.
Parameter Edit Module Entry and Exit Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. See Table 13 for the set of questions you will be asked if this option is enabled.
Parameter Edit General Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. See Table 14 for the set of questions you will be asked if this option is enabled.

Table 11. Configuration Parameter List - Node Level Traces

Parameter Information
Parameter Process management Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about the management of processes within the APPN network node, including the creation and termination of processes, processes entering a wait state, and the posting of processes.
Parameter Process to process communication Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about messages exchanged between processes in the APPN network node, including the queuing and receipt of such messages.
Parameter Locking Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about locks that were obtained and released on processes in the APPN network node.
Parameter Miscellaneous tower activities Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about miscellaneous activities within the APPN network node.
Parameter I/O to and from the system Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about the flow of messages entering and exiting the APPN network node.
Parameter Storage management Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about any shared memory that was obtained and released by the APPN network node.
Parameter Queue data type management Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about all calls in the APPN network node that manage general purpose queues.
Parameter Table data type management Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about all calls in the APPN network node that manage general purpose tables, including calls to add table entries and calls to query tables for specific entries.
Parameter Buffer management Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about buffers in the APPN network node that were obtained and released.
Parameter Configuration control Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about the activities of the configuration control component of the APPN network node. The configuration control component manages information about node resources.
Parameter Timer service Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about requests for timer service from the APPN network node.
Parameter Service provider management Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about the definition and enabling or disabling of services within the APPN network node.
Parameter Inter-process message segmenting Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about the buffer transfer and freeing of chained messages within the APPN network node.
Parameter Control of processes outside scope of this tower Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about the definition and activation of processes external to this APPN network node, such as when the node operator facility (NOF) defines the external process configuration control.
Parameter Monitoring existence of processes, services, towers Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about requests that start or stop the monitoring of processes or services within the APPN network node.
Parameter Distributed environment control Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about requests within the APPN network node that define subsystems and create environments.
Parameter Process to service dialogs Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this trace option causes the router trace facility to gather data about all calls within the APPN network node that open, close, or send data on a dialog.
Parameter AVL Tree Support Valid Values Yes, No Default No Description This parameter enables or disables this APPN trace option. When enabled, the trace option causes the router trace facility to gather data about all calls that manage AVL trees.

Table 12. Configuration Parameter List - Inter-process Signals Traces

Parameter Information
Parameter Address space manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the address space manager component.
Parameter Attach manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the attach manager component.
Parameter Configuration services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the configuration services component.
Parameter Dependent LU requester Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the dependent LU requester component.
Parameter Directory services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the directory services component.
Parameter Half Session Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the half session component.
Parameter HPR Path Control Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the HPR path control component.
Parameter LUA RUI Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the LUA RUI component.
Parameter Management Services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the management services component.
Parameter Node Operator Facility Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the node operator facility component.
Parameter Path Control Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the path control component.
Parameter Presentation Services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the presentation services component.
Parameter Resource manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the resource manager component.
Parameter Session connector manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the session connector manager component.
Parameter Session connector Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the session connector component.
Parameter Session manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the session manager component.
Parameter Session services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the session services component.
Parameter Topology and routing services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about inter-process signals from the topology and routing services component.

Table 13. Configuration Parameter List - Module Entry and Exit Traces

Parameter Information
Parameter Attach manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about module entry and exit information from the attach manager component.
Parameter Half session Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about module entry and exit information from the half session component.
Parameter LUA RUI Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about module entry and exit information from the LUA RUI component.
Parameter Node operator facility Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about module entry and exit information from the node operator facility component.
Parameter Presentation services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about module entry and exit information from the presentation services component.
Parameter Rapid transport protocol Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about module entry and exit information from the rapid transport control component.
Parameter Resource manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about module entry and exit information from the resource manager component.
Parameter Session manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about module entry and exit information from the session manager component.

Table 14. Configuration Parameter List - General Component Level Traces

Parameter Information
Parameter Accounting services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the accounting services component.
Parameter Address space manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the address space manager component.
Parameter Architected transaction programs Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the architected transaction programs component.
Parameter Configuration services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the configuration services component.
Parameter Dependent LU requester Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the dependent LU requester component.
Parameter Directory services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the directory services component.
Parameter HPR path control Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the HPR path control component.
Parameter LUA RUI Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the LUA RUI component.
Parameter Management services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the management services component.
Parameter Node operator facility Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the node operator facility component.
Parameter Path control Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the path control component.
Parameter Problem determination services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the problem determination component.
Parameter Rapid transport protocol Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the rapid transport control component.
Parameter Session connector manager Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the session connector manager component.
Parameter Session connector Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the session connector component.
Parameter Session services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the session services component.
Parameter SNMP subagent Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the SNMP subagent component.
Parameter TN3270E Server Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the TN3270E Server component.
Parameter Topology and routing services Valid Values Yes, No Default Value No Description This parameter enables or disables this APPN trace option. When enabled, this parameter informs the trace facility to include trace data about general information from the topology and routing services component.

Table 15. Configuration Parameter List - Miscellaneous Traces

Parameter Information
Parameter Data link control transmissions and receptions Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace all XIDs and PIUs transmitted and received by the APPN node.
Parameter Trace RTP Headers Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace all headers of RTP flows. This option is available only if Data link control transmissions and receptions is yes.
Parameter Include payload in RTP trace Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace the payload data in RTP flows. This option is available only if trace RTP headers is yes.
Parameter Filter the Data Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will filter the trace data according to the way you answer the following questions.
Parameter Truncate the data Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will truncate the trace data. You will be asked to specify the length to trace
Parameter Length to trace Valid Values 1 - 3600 Default Value 100 Description This parameter specifies the number of bytes of trace data to accumulate.
Parameter Trace Locates Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace locates.
Parameter Trace TDUs Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace topology data updates.
Parameter Trace route setups Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace route setups.
Parameter Trace CP Capabilities Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace CP Capabilities.
Parameter Trace Session Control Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace session control traffic.
Parameter Trace XIDs Valid Values Yes, No Default Value No Description If this parameter is enabled, the APPN trace facility will trace XIDs.

Syntax:

set

management

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 16. Configuration Parameter List - APPN Node Management

Parameter Information
Parameter Collect intermediate session information Valid Values Yes, No Default Value No Description This parameter specifies whether the APPN node should collect data on intermediate sessions passing through this node (session counters and session characteristics). The data is captured in SNMP MIB variables for APPN.
Parameter Save RSCV information for intermediate sessions Valid Values Yes, No Default Value No Description This parameter specifies whether the APPN node should save the Route Selection control vector (RSCV) for an intermediate session. The data is captured in an associated SNMP MIB variable for APPN. The session RSCV is carried in the BIND request used to activate a session between two LUs. It describes the optimum route through an APPN network for a particular LU-LU session. The session RSCV contains the CP names and TG associated with each pair of adjacent nodes along a route from an origin node to a destination node.
Parameter Create intermediate session records Valid Values Yes, No Default Value No Description This parameter enables or disables the creation of data records for intermediate sessions passing through this node. The records contain information about session counters and session characteristics. RSCV information is also included in the data records if the Save RSCV information for intermediate sessions parameter is enabled. If this parameter is set to yes, the setting of collect intermediate session information is overridden.
Parameter Record creation threshold Valid Values 0 to 4 294 967, in 1-KB increments Default Value 0 Description This parameter specifies a byte threshold for creating intermediate session records. When session data exceeds the value in this byte counter by an even multiple, a record is created.
Parameter Held alert queue size Valid Values 0 -- 255 Default Value 10 Description This parameter sets the size of the configurable held alert queue. This queue is used to save APPN alerts prior to sending them to a focal point. If the queue overflows, the oldest alerts are discarded.

Table 17. Configuration Parameter List - APPN ISR Recording Media

Parameter Information
Memory Parameters
Parameter Memory (see table notes) Valid Values Yes, No Default Value No Description This parameter enables or disables the collection of intermediate session data in the router's local memory.
Parameter Maximum memory buffers Valid Values 0 to 1 Default Value 1 Description This parameter specifies the number of buffers to be allocated in the router's local memory for storing intermediate session records.
Parameter Maximum memory records per buffer Valid Values 0 to 2000 Default Value 100 Description This parameter specifies the maximum number of intermediate session records that may be stored in the memory buffer on the router.
Parameter Memory buffers full Valid Values Stop recording (0), Wrap (1) Default Value Stop recording (0) Description This parameter specifies the action to take when the memory buffer allocated to store intermediate session records becomes full. Select Stop recording to instruct the router to discard any new intermediate session records. Select Wrap to allow new records to overwrite existing records in the buffer. The oldest records in the buffer are overwritten first.
Parameter Memory record format Valid Values ASCII (0), Binary (1) Default Value ASCII (0) Description This parameter specifies the format in which intermediate session records are to be stored in the router's local memory.
Parameter Topology safe store Valid Values Yes or No Default Value No Description This parameter specifies whether the topology data base is to be saved on the hardfile. This function is not supported if compact Flash memory is used. It can only be used when a hardfile is present.
Parameter Time between database updates Valid Values 60 -- 1440 minutes Default Value 60 Description This parameter sets the time in minutes between topology database updates.
Note: When you enable the collection of intermediate session records, the data associated with the records also is collected, by default, in SNMP MIB variables for APPN. The MIB variables are updated, in this case, whether or not the Collect intermediate session information parameter (in Table 16) has been enabled. Intermediate session data can be stored in router memory.

Add

Use the add command to add or update:

Syntax:

add

port

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 18. Configuration Parameter List - Port Configuration

Parameter Information
Parameter Link type Valid Values Ethernet (E) Token ring (T) DLSw (D) PPP (P) Frame relay (F) SDLC (S) X.25 (X) IP Default Value None Description This parameter specifies the type of link associated with this port.
Parameter Interface number Valid Values 0 to 65 533 Default Value 0 Description This parameter defines the physical interface number of the hardware interface to which this device is attached.
Parameter Port name Valid Values A string of 1 to 8 characters, where the first character is alphabetic and the 2nd through 8th characters are alphanumeric. Default Value A unique unqualified name that is automatically generated. The name will consist of: TR (token-ring) EN (Ethernet) DLS (DLSw) IP255 FR (Frame Relay) X25 (X.25) SDLC (SDLC) PPP (point-to-point) IP followed by the interface number. You can change the port name to a name of your choice. Description This parameter specifies the name representing this port.
Parameter Enable APPN routing on this port Valid Values Yes, No Default Value Yes Description This parameter specifies whether APPN routing is to be enabled on this port.
Parameter Support multiple PU Valid Values Yes, No Default Value No Description This parameter specifies whether the port will support multiple subarea.
Parameter Service any node Valid Values Yes No Default Value Yes Description This parameter specifies how the router network node responds to a request from another node to establish a connection over this port. When this parameter is enabled, the network node accepts any request it receives from another node to establish a connection. When this parameter is disabled, the network node accepts connection requests only from nodes that you explicitly define (via link station definitions). This option provides an added level of security for the router network node. Note: When you disable this parameter, a connection request from an adjacent node will be accepted only if the node's fully-qualified CP name parameter has been configured for a link station defined on this port. When this parameter is enabled (the default), you may still want this network node to be able to initiate connections with specific nodes over this port.
Parameter Treat non-configured callers as LEN nodes Valid Values Yes, No Default Value No Description This parameter specifies whether APPN should treat dynamic Network Node callers that do not request CP-CP sessions as LEN nodes. It is applicable only if service any node is yes. If this parameter is yes: the router treats the adjacent node as a LEN node regardless of the node type in the received XID3 the router sends XID3s stating that the router is a LEN node (an EN with no CP-CP session and no HPR support)
Parameter High-performance routing (HPR) supported Valid Values Yes, No Default Value Yes for token-ring, Ethernet, Frame Relay, and PPP ports. Description This parameter indicates whether link stations on this port will support HPR. This value may be overridden on the link station definition.
Parameter IPv4 Precedence Valid Values Yes or No Default Value No Description This parameter sets the IPv4 precedence value, which allows BRS precedence filtering of IPv4 encapsulated packets.
Parameter Limited Resource ( PPP and FR over dial circuits only) Valid Values Yes, No Default Value If the dial circuit is dial on demand, the default is Yes. Otherwise, the default is No. Description This parameter specifies whether link stations on this port are a limited resource. This value may be overridden on the link station definition.
Parameter Support bridged formatted frames (Frame relay only) Valid Values Yes, No Default Value No Description This parameter specifies whether the Frame Relay port will support bridged formatted frames. If you are configuring Frame Relay to support bridged format, you will also need to configure a boundary node identifier.
Parameter Boundary node identifier (Frame Relay only) Valid Values X'0000 0000 0001' to X'7FFF FFFF FFFF' Default Value X'4FFF 0000 0000' Description This parameter specifies the boundary node identifier MAC address. The router uses this MAC address to recognize that the frame is a Frame Relay bridged frame destined for APPN.
Parameter Subnet visit count Valid Values 1 - 255 Default Value Default taken from the equivalent node level parameter Description This parameter specifies this port's default for the maximum number of subnetworks that a multi-subnet session may traverse. Note: This question is asked only if the border node function is enabled on this node.
Parameter Adjacent node subnet affiliation Valid Values 0 (native) 1 (non-native) 2 (negotiable) Default Value 2 Description This parameter specifies the default for all links through this port as to whether the adjacent node is in this node's native APPN subnetwork or in a non-native APPN subnetwork. A value of 2 instructs the node to negotiate at link activation time to determine whether the adjacent link station is native or non-native. Note: This question is asked only if the border node function is enabled on this node.

Table 19. Configuration Parameter List - Port Definition

Parameter Information
Parameter Maximum BTU size Valid Values 768 to 1496 bytes for Ethernet 768 to 17 745 bytes for token-ring 768 to 4096 bytes for IP 768 to 8136 bytes for Frame Relay 768 to 8132 bytes for Frame Relay over ISDN and V.25 bis 768 to 4086 bytes for PPP 768 to 4082 bytes for PPP over ISDN and V.25 bis X.25 will take value from network level 768 to 2048 bytes for all other ports Default Value 1289 bytes for Ethernet 2048 bytes for token-ring 1469 bytes for IP 2048 bytes for Frame Relay or PPP 2044 bytes for Frame Relay or PPP over ISDN and V.25 bis 2048 bytes for SDLC X.25 will take value from network level Description This parameter specifies the number of bytes in the largest basic transmission unit (BTU) that can be processed (transmitted or received) by a link station defined on this port. Note: If a negotiable BIND with an RU size greater than 2048 is received, the device will normally choose a maximum RU size of 2048. If a non-negotiable BIND with an RU size greater than 2048 is received, the device will support the larger RU size up to a maximum size of 4096.
Parameter Maximum number of link stations Valid Values 1 to 127 for SDLC ports 1 to 65 535 for all other ports Default Value If SDLC is configured as multipoint and primary, then this parameter defaults to 127. Description This parameter specifies the maximum number of link stations that will be allowed to use this port. This parameter allows the resources for the APPN node and this port to be constrained.
Parameter Percent of link stations reserved for incoming calls (Ethernet, token-ring, FR, X.25 only) Valid Values 0 to 100 The sum of the percent of link stations reserved for incoming calls and the percent of link stations reserved for outgoing calls cannot exceed 100%. Default Value 0 Description This parameter specifies the percentage of the maximum number of link stations that will be reserved for incoming calls. Link stations that are not reserved for incoming or outgoing calls are available for either purpose on a demand basis.
Parameter Percent of link stations reserved for outgoing calls Valid Values 0 to 100 The sum of the percent of link stations reserved for incoming calls and the percent of link stations reserved for outgoing calls cannot exceed 100%. If SDLC primary and multipoint, then valid value is 100. Default Value 0 If SDLC primary and multipoint, then default value is 100. Description This parameter specifies the percentage of the maximum number of link stations that will be reserved for outgoing calls. Fractions resulting from the computation are truncated. Link stations that are not reserved for incoming or outgoing calls are available for either purpose on a demand basis.
Parameter UDP port number for XID exchange Valid Values 1024 to 65 535 Default Value 11 000 Description This parameter specifies the UDP port number to be used for XID exchange and is used during IP port definition. This port number must be the same as the one defined on other devices in the network.
Parameter UDP port number for network priority traffic Valid Values 1024 to 65 535 Default Value 11 001 Description This parameter specifies the UDP port number to be used for network priority traffic.
Parameter UDP port number for high priority traffic Valid Values 1024 to 65 535 Default Value 11 002 Description This parameter specifies the UDP port number to be used for high priority traffic.
Parameter UDP port number for medium priority traffic Valid Values 1024 to 65 535 Default Value 11 003 Description This parameter specifies the UDP port number to be used for medium priority traffic.
Parameter UDP port number for low priority traffic Valid Values 1024 to 65 535 Default Value 11 004 Description This parameter specifies the UDP port number to be used for low priority traffic.
Parameter IP network type Valid Values Campus or Widearea Default Value Widearea Description This parameter specifies the IP network type.
Parameter Local APPN SAP address Valid Values Multiples of four in the hexadecimal range X'04' to X'EC' Default Value X'04' Description This parameter specifies the local SAP address to be used for communicating with APPN link stations defined on this port.
Parameter Local HPR SAP address (Ethernet and token-ring only) Valid Values Multiples of four in the hexadecimal range X'04' to X'EC' Default Value X'C8' Description This parameter indicates the local service access point to be used for communicating with HPR link stations defined on this port.
Parameter Branch uplink Valid Values Yes or No Default Value No Description This parameter indicates whether the default for link stations using this port will be uplink or downlink. If yes is specified, link stations using this port will default Branch uplink to yes. Notes: This question is asked only if the node-level parameter Enabled Branch Extender is yes. If Branch uplink is yes, the Branch Extender will present its end node appearance to this link station. Otherwise, the Branch Extender will present its network node appearance. Typically, Branch uplink is yes for WAN-attached network nodes and is no for LAN-attached end nodes.

Table 20. Configuration Parameter List - Port Default TG Characteristics

Parameter Information
Parameter Cost per connect time Valid Values 0 to 255 Default Value For IP: 0 for Campus and WAN For all other: 0 Description This parameter specifies the cost per connect time TG characteristic for all link stations on this port. The cost per connect time TG characteristic expresses the relative cost of maintaining a connection over the associated TG. The units are user-defined and are typically based on the applicable tariffs of the transmission facility being used. The assigned values should reflect the actual expense of maintaining a connection over the TG relative to all other TGs in the network. A value of zero means that connections over the TG may be made at no additional cost (as in the case of many non-switched facilities). Higher values represent higher costs.
Parameter Cost per byte Valid Values 0 to 255 Default Value For IP: 0 for Campus and WAN For all other: 0 Description This parameter specifies the cost per byte TG characteristic for all link stations defined on this port. The cost per byte TG characteristic expresses the relative cost of transmitting a byte over the associated TG. The units are user-defined and the assigned value should reflect the actual expenses incurred for transmitting over the TG relative to all other TGs in the network. A value of zero means that bytes may be transmitted over the TG at no additional cost. Higher values represent higher costs.
Parameter Security Valid Values Nonsecure all else (for example, satellite-connected, or located in a nonsecure country). Public switched network secure in the sense that route is not predetermined Underground cable located in secure country (as determined by the network administrator) Secure conduit Not guarded, (for example, pressurized pipe) Guarded conduit protected against physical tapping Encrypted link-level encryption is provided Guarded radiation guarded conduit containing the transmission medium; protected against physical and radiation tapping Default Value For IP: Campus Nonsecure WAN Public switched network For all other: Nonsecure Description This parameter specifies the security TG characteristic for all link stations defined on this port. The security TG characteristic indicates the level of security protection associated with the TG. If security attributes other than the architecturally-defined ones are needed, one of the user-defined TG characteristics may be used to specify additional values.
Parameter Propagation delay Valid Values Minimum LAN less than 480 microseconds Telephone between .48 and 49.152 milliseconds Packet switched between 49.152 and 245.76 milliseconds Satellite greater than 245.76 milliseconds maximum Default Value For IP: Campus Telephone WAN Packet switched Description This parameter specifies the propagation delay TG characteristic for all link stations defined on this port. The propagation delay TG characteristic specifies the approximate range for the length of time that it takes for a signal to propagate from one end of the TG to the other.
Parameter Effective capacity Valid Values 2 hexadecimal digits in the range X'00' to X'FF' Default Value   FR=X'45' (64 kbps)  PPP=X'45' (64 kbps) DLSw=X'75' (4 Mbps) SDLC=X'45' (64 kbps)  X.25=X'45' (64 kbps) Token ring: X'75' when minimum is 4 Mbps Token ring: X'85' when minimum is 16 Mbps Ethernet/802.3 ports: X'80' for 10 Mbps 100Mbps Ethernet: X'9A' For IP: Campus: X'75' WAN: X'43' Description This parameter specifies the effective capacity TG characteristic for all associated connections (TGs) on this port. This parameter specifies the maximum bit transmission rate for both physical links and logical links. Note that the effective capacity for a logical link may be less than the physical link speed. The rate is represented in COS files as a floating-point number encoded in a single byte with units of 300 bps. The effective capacity is encoded as a single-byte representation. The values X'00' and X'FF' are special cases used to denote minimum and maximum capacities. The range of the encoding is very large; however, only 256 values in the range may be specified. This parameter provides the default value for the Effective capacity parameter on the Modify TG Characteristics Command Line option. The Modify TG Characteristics Command Line option enables you to override the .* default values assigned to TG characteristics on the individual link stations you define.
Parameter First user-defined TG characteristic Valid Values 0 to 255 Default Value 128 Description This parameter specifies the first user-defined TG characteristic for all link stations defined on this port. The first user-defined TG characteristic specifies the first of three additional characteristics that users can define to describe the TGs in a network. The default value of 128 allows a subset of TGs to be defined as more or less desirable than the rest without defining values for all TGs.
Parameter Second user-defined TG characteristic Valid Values 0 to 255 Default Value 128 Description This parameter specifies the second user-defined TG characteristic for all link stations defined on this port. The second user-defined TG characteristic specifies the second of three additional characteristics that users can define to describe the TGs in a network.
Parameter Third user-defined TG characteristic Valid Values 0 to 255 Default Value 128 Description This parameter specifies the third user-defined TG characteristic for all link stations defined on this port. The third user-defined TG characteristic specifies the third of three additional characteristics that users can define to describe the TGs in a network.

Table 21. Configuration Parameter List - Port default LLC Characteristics

Parameter Information
Parameter Remote APPN SAP Valid Values Multiples of four in the hexadecimal range of X'04' to X'EC' Default Value X'04' Description This parameter specifies the SAP associated with an adjacent node's APPN link station.
Parameter Maximum number of outstanding I-format LPDUs (TW) Valid Values 1 to 127 Default Value 26 Description This parameter specifies the LLC maximum number of outstanding I-format LPDUs (TW) for all link stations on this port. The maximum number of outstanding I-format LPDUs defines the transmit Command Line option (TW) which is the maximum number of sequentially numbered I-format LPDUs that the link station may have unacknowledged at any given time.
Parameter Receive window size Valid Values 1 to 127 Default Value 26 Description This parameter specifies the LLC receive Command Line option size (RW) for all link stations on this port. The RW parameter specifies the maximum number of unacknowledged sequentially numbered I-format LPDUs that the link station can receive from the remote link station. RW is advertised in SNA XID frames and IEEE 802.2 XID frames. The XID receiver should set its effective TW to a value less than or equal to the value of the received RW to avoid overruns.
Parameter Inactivity timer (Ti) Valid Values 1 to 254 seconds Default Value 30 seconds Description This parameter specifies the LLC inactivity timer (Ti) for all link stations on this port. An LLC link station uses Ti to detect an inoperative condition in either the remote link station or in the transmission media. If an LPDU is not received in the time interval specified by Ti, an S-format command LPDU with the poll bit set is transmitted to solicit remote link station status. Recovery is then based on the reply timer (T1).
Parameter Reply timer (T1) Valid Values 1 to 254 seconds Default Value 2 seconds Description This parameter specifies the LLC reply timer (T1) for all link stations on this port. An LLC link station uses T1 to detect a failure to receive a required acknowledgment or response from the remote link station. When T1 expires, the link station sends an S-format command link layer protocol data unit (LPDU) with the poll bit set to solicit remote link station status or any U-format command LPDUs that have not been responded to. The duration of T1 should take into account any delays introduced by underlying layers.
Parameter Maximum number of retransmissions (N2) Valid Values 1 to 254 Default Value 8 Description This parameter specifies the maximum number of retransmissions (N2) for all link stations on this port. The N2 parameter specifies the maximum number of times an LPDU will be retransmitted following expiration of the reply timer (T1).
Parameter Receive acknowledgment timer (T2) Valid Values 1 to 254, measured in tenths of a second Default Value 1 Description This parameter specifies the LLC receiver acknowledgment timer (T2) for all link stations on this port. The T2 parameter may be used with the N3 counter to reduce acknowledgment traffic. A link station uses T2 to delay the sending of an acknowledgment for a received I-format LPDU. T2 is started when an I-format LPDU is received, and reset when an acknowledgment is sent in an I-format or S-format LPDU. If T2 expires, the link station must send an acknowledgment as soon as possible. The value of T2 must be less than that of T1, to ensure that the remote link station will receive the delayed acknowledgment before its T1 expires.
Parameter Acknowledgments needed to increment working window Valid Values 0 to 127 Default Value 1 Description When the working window (Ww) is not equal to the Maximum Transmit Window Size (Tw), this parameter is the number of transmitted I-format LPDUs that must be acknowledged before the working window can be incremented (by 1). When congestion is detected, by the loss of I-format LPDUs, Ww is set to 1.

Table 22. Configuration Parameter List - HPR Override Defaults

Parameter Information
Parameter Inactivity timer override for HPR (HPR Ti) Valid Values 1 to 254 seconds Default Value 2 seconds Description This parameter specifies the LLC inactivity timer (HPR Ti) that is to be used for all link stations on this port supporting HPR when the HPR supported parameter is enabled on this port. This default overrides the value of the default LLC inactivity timer (Ti) parameter specified on the default LLC characteristics parameter.
Parameter Reply timer override for HPR (HPR T1) Valid Values 1 to 254 seconds Default Value 2 seconds Description This parameter specifies the LLC reply timer (HPR T1) that is to be used for all link stations on this port supporting HPR when the HPR supported parameter is enabled on this port. This default overrides the value of the default LLC reply timer (T1) parameter specified on the default LLC characteristics parameter.
Parameter Maximum number of retransmissions for HPR (HPR N2) Valid Values 1 to 254 Default Value 3 Description This parameter specifies the LLC maximum number of retransmissions (HPR N2) that is to be used for all link stations on this port supporting HPR when the HPR supported parameter is enabled on this port. This default overrides the value of the default LLC maximum number of retransmissions (N2) parameter specified on the default LLC Characteristics parameter.

Syntax:

add

link-station

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 23. Configuration Parameter List - Link Station - Detail

Parameter Information
Parameter Does link support APPN function Valid Values Yes or No Default Value Yes Description This parameter specifies whether this link station will support APPN function. If the answer is no, questions concerning CP-CP sessions, security, encryption, CP name, adjacent node type, branch extender, and extended border node will not be asked and all of these functions will be disabled. Also, HPR will be disabled and no HPR questions will be asked.
Parameter Link station name (required) Valid Values A string of 1 to 8 characters : First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name of a link station that represents the TG (link) between the router network node and the adjacent node. The link station name must be unique within this network node.
Parameter Port name Valid Values A unique unqualified name that is automatically generated. The name will consist of: TR (token-ring) EN (Ethernet) DLS (DLSw) FR (Frame Relay) X25 (X.25) SDLC (SDLC) PPP (point-to-point) IP followed by the interface number. Default Value The name of the port that this link station is defined on. Description This parameter specifies the name representing the port this link station is defined on. The port must already have been configured for APPN.
Parameter Link type (X.25 only) If limited resource = yes is configured for this link station, then the link type parameter defaults to a value of 1 (SVC) and is not configurable. Valid Values If PVC, then specify a logical channel number in the range of 1 - 4095 If SVC, then specify a DTE address that is variable length up to 15 digits Default Value 0, unless it is a limited resource. Description This parameter specifies whether the X.25 link is a PVC or SVC.
Parameter MAC address of adjacent node (required) (Ethernet, token-ring, DLSw, FR bridged format only) Valid Values Token-ring and DLSw ports: 12 hexadecimal digits in the range X'000000000001' to X'7FFFFFFFFFFF' Ethernet/802.3 ports: 12 hexadecimal digits in the form X'xyxxxxxxxxxx' where: x is any hexadecimal digit y is a hexadecimal digit in the set {0, 2, 4, 6, 8, A, C, E} Default Value None Description This parameter specifies the medium access control (MAC) layer address of the adjacent node. Different formats are used for token-ring and Ethernet/802.3. Token-ring and DLSw ports: The MAC address is specified in noncanonical form. In the noncanonical address format, the bit within each octet that is to be transmitted first is represented as the most significant bit. Ethernet/802.3 ports: The MAC address is specified in canonical form. In the canonical address format, the bit within each octet that is to be transmitted first is represented as the least significant bit.
Parameter IP address of adjacent node (Enterprise Extender only) Valid Values Any valid IP address Default Value none Description Each link on the HPR/IP port must have a unique destination IP address.
Parameter Adjacent node type Valid Values APPN network node, APPN end node, LEN end node Default Value APPN network node Description This parameter identifies whether the adjacent node is an APPN node, a low-entry networking (LEN) end node. When APPN end node is selected and Limited resource is No, APPN changes the adjacent node type internally to learn and will work with any node type. When APPN end node is selected and Limited resource is Yes, the adjacent node type is unchanged. When you select LEN end node, the fully-qualified control point name parameter is a required parameter. If this network node is communicating with the IBM Virtual Telecommunications Access Method (VTAM) product through the LEN node, and the LEN node is not a T2.1 node or does not have an explicitly defined control point (CP) name, then the router network node's XID number for the Subarea connection parameter also must be specified to establish a connection. Note: LEN end node is not a valid node type for HPR/IP interface.
Parameter XID node identification Valid Values A string of 8 hex digits (0-F) Default Value X'00000000' Description This parameter specifies the ID block and ID number fields that identify the adjacent node. It is applicable only when the Adjacent node type field is set to LEN end node. If you choose yes for replace inbound XID3 CP name and XID with configured values, the value of this field replaces the corresponding parameters in the received XID.
Parameter fully-qualified CP name of adjacent node Valid Values A string of up to 17 characters in the form of netID.CPname, where: netID is a network ID from 1 to 8 characters CPname is a control point name from 1 to 8 characters Each name must conform to the following rules: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing fully-qualified CP name, using the special characters @, $, and from the character set A, continues to be supported; however, these characters should not be used for new CP names. Default Value None Description This parameter specifies the fully-qualified CP name of the adjacent node. For the cases where this parameter is not required, the adjacent node's CP name may be learned dynamically during XID exchange; however, if a CP name is specified, it must match the adjacent node's definition for the link to be successfully activated. Note: This parameter is required when any of the following occur: The Service any node parameter is set to Disable. The Adjacent node type parameter is set to LEN end node. The CP-CP session level security parameter is set to Enable. The link is a limited resource.
Parameter Replace inbound XID3 CP name and XID with configured values Valid Values Yes or No Default Value No Description This parameter specifies whether or not the router should override the node id and CP name parameters received in XIDs from a configured LEN node. It is applicable only when the adjacent node type field is set to LEN end node. If you have a large number of LEN nodes that are not configured adequately to participate in a full APPN network, you can configure their identity at the router and have the router override the values in their XIDs before forwarding those XIDs on.
Parameter Activate link automatically If limited resource, then this parameter is set to No and is not configurable. Valid Values Yes, No Default Value Yes Description When this parameter is enabled, the router network node automatically activates the link to the adjacent node and initiates a connection.
Parameter Retry link activation unconditionally Valid Values Yes, No Default Value No Description This parameter specifies whether or not the router should always try to reactivate the link regardless of the cause of link failure. It is applicable only for dial-out capable links where activate link automatically is yes. Normally if a link fails to start or comes down due to some event other than an operator command, the router selectively chooses whether to reactivate it. If the failure cause is likely to require reconfiguration of one of the two nodes, the router does not automatically restart the link. This avoids a periodic repeat (with logging, alerting, etc.) of the unsuccessful connection attempt. If you want to override this behavior and have links always attempt to reconnect, select yes for this parameter.
Parameter Allow CP-CP sessions on this link Valid Values Yes, No Default Value Yes, if adjacent node type is APPN network node or APPN end node. No for all other adjacent node types Description This parameter specifies whether sessions between control points are to be activated over this link station. This parameter allows control of CP-CP session establishment between adjacent network nodes so that the overhead associated with topology database updates (TDUs) may be constrained. Note: Every APPN network node must have at least one CP-CP session established to another APPN network node in order to maintain the minimum connectivity necessary to update the topology database. In addition, more than minimum connectivity could be desired to eliminate single points of failure and to improve network dynamics.
Parameter CP-CP session level security Valid Values Yes, No Default Value No Description This parameter specifies whether session level security is enforced for CP-CP sessions established over this link station. When session level security is enabled, encrypted data is exchanged and compared during the BIND flows (which includes the BIND, the BIND response, and an FMH-12 Security RU). To successfully establish a CP-CP session with session level security enabled, both partners must be configured with the same encryption key. Currently, session level security support is limited to the basic LU-LU verification protocol.
Parameter Encryption key Valid Values Up to 16 hexadecimal digits. If fewer than 16 digits are specified, the value is padded on the right with zeros. Default Value None Description This parameter is used to encrypt data exchanged during BIND flows. Both partners must be configured with the same key to establish a CP-CP session.
Parameter Use enhanced session security (If security is enabled) Valid Values Yes, No Default Value No
Parameter High-performance routing (HPR) supported Valid Values Yes, No Default Value APPN network node, APPN end node or LEN end node: the value specified in the default HPR supported parameter for this port All other adjacent node types: No Description This parameter indicates whether this link station supports HPR. The user should disable HPR support if the underlying link is unreliable. An HPR connection will not be established unless both link stations advertise HPR support during XID exchange.
Parameter DLCI number for link (Frame Relay only) Valid Values 16 to 1007 Default Value 16 Description The DLCI parameter identifies the frame-relay logical data link connection with the adjacent node.
Parameter Station address of adjacent node (SDLC only) Valid Values Address in the range of (1 - FE) Default Value C1 Description This parameter specifies the address of the adjacent node.
Parameter Limited Resource (PPP, X.25 FR over dial circuits) Valid Values Yes, or No Default Value No If the link type is PPP or FR, the default will be taken from the limited resource parameter for the associated port. Description This parameter specifies whether the TG for this link station is a limited resource. If you answer yes, then the Virtual Channel Type is SVC.
Parameter Branch Uplink Valid Values Yes or No Default Value The value specified for Branch Uplink on the port. Description This parameter indicates whether this link will be a Branch uplink (to WAN) or Branch downlink (to LAN). This question is asked only if Enabled Branch Extender has been set to yes and if this link station is not a network node. If Enabled Branch Extender has been set to yes and this link station is a network node, then Branch Uplink defaults to yes
Parameter Is uplink to another Branch Extender node Valid Values Yes or No Default Value No Description This parameter indicates whether or not the adjacent node has the Branch Extender function enabled. This question is asked only if Branch Extender is enabled on this node, this is an uplink, and the uplink is a limited resource.
Parameter Preferred Network Node Server Valid Values Yes or No Default Value No Description This parameter indicates whether this uplink is to a network node server that is to be used as the network node server for the node supporting Branch Extender function and acting as an end node. If yes is specified, this uplink will be used as the network node server for this node. This question will be asked only if: Enabled Branch Extender is yes, This station is a network node, Branch Uplink is yes, and CP-CP sessions are supported on this link.
Parameter TG Number Valid Values If limited resource is Yes, valid values are 1 - 20. If limited resource is No and link type is X.25 SVC, valid values are 0 - 20. Otherwise, valid values are 0 - 20. Default Value If limited resource is Yes, default is 1. If limited resource is No, default is 0. Otherwise, default value is 0. Description This parameter uniquely identifies a TG between adjacent nodes.
Parameter Solicit SSCP session Valid Values Yes or No Default Value No If the link station name is the same as the CP name, then the default is yes. Description This parameter indicates whether this link is to solicit SSCP sessions.
Parameter Local Node ID Valid Values 5 hexadecimal digits Default Value X'00000' Description This parameter specifies the local node identifier that represents the local dependent PU to VTAM. This question is asked only if Solicit SSCP session is yes. The local node id must be unique.
Parameter Enable Host Initiated Dynamic LU Definition Valid Values Yes or No Default Value No Description This parameter indicates whether or not dependent LUs will be created dynamically (as opposed to having to be configured.) If yes is specified, LUs will be defined for this PU as ACTLU requests (with CV0E) are received. With this feature, LUs for the TN3270E Server do not have to be configured. Note: This question is asked only if Solicit SSCP session is yes.
Parameter Pool Name for Host-initiated Dynamic LUs Valid Values A string of 1 to 8 characters: First character: A to Z, $, #, @, or < Second to eighth characters: A to Z, 0 to 9, $, #, @, >, or < Default Value None Description This parameter specifies the name of a pool to be created to contain LUs that the host activates on this subarea link. This parameter is applicable only if Solicit SSCP session is yes, and Enable Host Initiated Dynamic LU Definition is yes. You do not need to use the add implicit-pool command to define this pool; specifying the name and other parameters here is sufficient to cause the pool to be created. If you do enter a pool name, you will be prompted to enter values for the following parameters: Pool class (See Table 39) LU type (See Table 39) You can provide the same pool name for multiple subarea links, if you wish. By specifying pool information, you cause host-initiated LUs that are not already configured at the router to be placed into the specified pool. TN3270 clients can then be assigned to them by requesting the pool name, or by mapping client IP addresses or destination ports to that pool. If you do not specify pool information, these host-initiated LUs are treated as explicit LUs and can only be assigned to clients that request them by their individual LU names.
Parameter Local SAP address Valid Values Any valid SAP address between X'04' and X'EC'. Default Value Value taken from port Description This parameter specifies local SAP address. Notes: This question is displayed only if there are multiple PUs defined on the port. If the local SAP address is not the main local SAP address on the port, the port name and SAP name will display in monitoring and SNMP display output.
Parameter Send Terminate-Self when TN3270 Client Disconnects Valid Values Yes or No Default Value No Description This parameter indicates whether or not a terminate_self request will be sent to the SSCP when the TN3270 client disconnects. If yes is specified, terminate_self will be sent and the host will be responsible for terminating the LU-LU session (i.e., the SLU will NOT send an UNBIND request.)
Parameter Subnet visit count Valid Values 1 - 255 Default Value Default taken from the equivalent port level parameter Description This parameter specifies the default for the maximum number of subnetworks that a multi-subnet session may traverse. Note: This question is asked only if the border node function is enabled on this node.
Parameter Adjacent node subnet affiliation Valid Values 0 (native) 1 (non-native) 2 (negotiable) Default Value Default is taken from the equivalent port level parameter Description This parameter specifies whether the adjacent node is in this node's native APPN subnetwork or in a non-native APPN subnetwork. A value of 2 instructs the node to negotiate at link activation time to determine whether the adjacent link station is native or non-native. Note: This question is asked only if the border node function is enabled on this node.

Table 24. Configuration Parameter List - Modify TG Characteristics

Parameter Information
Parameter Cost per connect time Valid Values 0 to 255 Default Value Default value is taken from the associated port parameter. Description This parameter expresses the relative cost of maintaining a connection over the associated TG. The units are user-defined and are typically based on the applicable tariffs of the transmission facility being used. The assigned values should reflect the actual expense of maintaining a connection over the TG relative to all other TGs in the network. A value of zero means that connections over the TG may be made at no additional cost (as in the case of many non-switched facilities). Higher values represent higher costs.
Parameter Cost per byte Valid Values 0 to 255 Default Value Default value is taken from the associated port parameter. Description This parameter expresses the relative cost of transmitting a byte over the associated TG. The units are user-defined and the assigned value should reflect the actual expenses incurred for transmitting over the TG relative to all other TGs in the network. A value of zero means that bytes may be transmitted over the TG at no additional cost. Higher values represent higher costs.
Parameter Security Valid Values Nonsecure - all else (for example, satellite-connected, or located in a nonsecure country). Public switched network - secure in the sense that route is not predetermined. Underground cable - located in secure country (as determined by the network administrator). Secure conduit - Not guarded, (for example, pressurized pipe). Guarded conduit - protected against physical tapping. Encrypted - link-level encryption is provided. Guarded radiation - guarded conduit containing the transmission medium; protected against physical and radiation tapping. Default Value Default value is taken from the associated port parameter. Description This parameter indicates the level of security protection associated with the TG. If security attributes other than the architecturally-defined ones are needed, one of the user-defined TG characteristics may be used to specify additional values.
Parameter Propagation delay Valid Values Minimum LAN - less than 480 microseconds Telephone - between .48 and 49.152 milliseconds Packet switched - between 49.152 and 245.76 milliseconds Satellite - greater than 245.76 milliseconds Maximum Default Value Default value is taken from the associated port parameter. Description This parameter specifies the approximate range for the length of time that it takes for a signal to propagate from one end of the TG to the other.
Parameter Effective capacity Valid Values 2 hexadecimal digits in the range X'00' to X'FF' Default Value Default value is taken from the associated port parameter. Description This parameter specifies the maximum bit transmission rate for both physical links and logical links. Note that the effective capacity for a logical link may be less than the physical link speed. The effective capacity is encoded as a single-byte representation. The values X'00' and X'FF' are special cases used to denote minimum and maximum capacities. The range of the encoding is very large; however, only 256 values in the range may be specified.
Parameter First user-defined TG characteristic Valid Values 0 to 255 Default Value Default value is taken from the associated port parameter. Description This parameter specifies the first of three additional characteristics that users can define to describe the TGs in a network.
Parameter Second user-defined TG characteristic Valid Values 0 to 255 Default Value Default value is taken from the associated port parameter. Description This parameter specifies the second of three additional characteristics that users can define to describe the TGs in a network.
Parameter Third user-defined TG characteristic Valid Values 0 to 255 Default Value Default value is taken from the associated port parameter. Description This parameter specifies the third of three additional characteristics that users can define to describe the TGs in a network.

Table 25. Configuration Parameter List - Modify Dependent LU Server

Parameter Information
Parameter fully-qualified CP name of primary DLUS Valid Values A string of up to 17 characters in the form of netID.CPname, where: netID is a network ID from 1 to 8 characters CPname is a control point name from 1 to 8 characters Each name must conform to the following rules: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing fully-qualified CP name, using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new CP names. Default Value The value specified in the default fully-qualified CP name of primary dependent LU server parameter. Description This parameter specifies the fully-qualified CP name of the dependent LU server (DLUS) that is to be used for incoming requests from the downstream PU associated with this link station.
Parameter fully-qualified CP name for backup DLUS Valid Values A string of up to 17 characters in the form of netID.CPname, where: netID is a network ID from 1 to 8 characters CPname is a control point name from 1 to 8 characters Each name must conform to the following rules: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing fully-qualified CP name, using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new CP names. Default Value The value specified in the default fully-qualified CP name of backup dependent LU server parameter. Description This parameter specifies the fully-qualified CP name of the dependent LU server (DLUS) that is to be used as a backup for the downstream PU associated with this link station. This parameter allows the default backup server to be overridden. A backup is not required, and the NULL value indicates the absence of a backup server. Note that NULL can be specified even when a default backup server has been defined (by erasing the default value that appears for this parameter).

Table 26. Configuration Parameter List - Modify LLC Characteristics

Parameter Information
Parameter Remote APPN SAP Valid Values Multiples of four in the hexadecimal range of X'04' to X'EC'. Default Value Default value is taken from the associated port parameter. Description This parameter specifies the Destination SAP (DSAP) address on the destination node to which data will be sent. This DSAP address value will appear in the LLC frame to identify the service access point (SAP) address associated with the adjacent node's APPN link station.
Parameter Maximum number of outstanding I-format LPDUs (TW) Valid Values 1 to 127 Default Value Default value is taken from the associated port parameter. Description This parameter specifies the transmit Command Line option which is the maximum number of sequentially numbered I-format LPDUs that the link station may have unacknowledged at any given time.
Parameter Receive window size Valid Values 1 to 127 Default Value Default value is taken from the associated port parameter. Description This parameter specifies the maximum number of unacknowledged sequentially numbered I-format LPDUs that the LLC link station can receive from the remote link station. RW is advertised in SNA XID frames and IEEE 802.2 XID frames. The XID receiver should set its effective TW to a value less than or equal to the value of the received RW to avoid overruns.
Parameter Inactivity timer (Ti) Valid Values 1 to 254 seconds Default Value Default value is taken from the associated port parameter. Description A link station uses Ti to detect an inoperative condition in either the remote link station or in the transmission media. If an LPDU is not received in the time interval specified by Ti, an S-format command LPDU with the poll bit set is transmitted to solicit remote link station status. Recovery is then based on the reply timer (T1).
Parameter Reply timer (T1) Valid Values 1 to 254 seconds Default Value Default value is taken from the associated port parameter. Description A link station uses T1 to detect a failure to receive a required acknowledgment or response from the remote link station. When T1 expires, the link station sends an S-format command link layer protocol data unit (LPDU) with the poll bit set to solicit remote link station status or any U-format command LPDUs that have not been responded to. The duration of T1 should take into account any delays introduced by underlying layers.
Parameter Maximum number of retransmissions (N2) Valid Values 1 to 254 Default Value Default value is taken from the associated port parameter. Description This parameter specifies the maximum number of times an LPDU will be retransmitted following the expiration of the reply timer (T1).
Parameter Receive acknowledgment timer (T2) Valid Values 1 to 254, measured in tenths of a second Default Value Default value is taken from the associated port parameter. Description This parameter may be used in conjunction with the N3 counter to reduce acknowledgment traffic. A link station uses T2 to delay the sending of an acknowledgment for a received I-format LPDU. T2 is started when an I-format LPDU is received, and reset when an acknowledgment is sent in an I-format or S-format LPDU. If T2 expires, the link station must send an acknowledgment as soon as possible. The value of T2 must be less than that of T1, to ensure that the remote link station will receive the delayed acknowledgment before its T1 expires.
Parameter Acknowledgment needed to increment working window Valid Values 0 to 127 acknowledgments Default Value Default value is taken from the associated port parameter. Description When the working window (Ww) is not equal to the Maximum Transmit Window Size (Tw), this parameter is the number of transmitted I-format LPDUs that must be acknowledged before the working window can be incremented (by 1). When congestion is detected, by the lost of I-format LPDUs, Ww is set to 1.

Table 27. Configuration Parameter List - Modify HPR Defaults

Parameter Information
Parameter Inactivity timer override for HPR (HPR Ti) Valid Values 1 to 254 seconds Default Value Default value is taken from the associated port parameter. Description This parameter specifies the HPR override LLC inactivity timer (HPR Ti) that is to be used when HPR is supported by this link station. This parameter overrides the value taken from the default inactivity timer override for the HPR parameter. This parameter supersedes the value of the LLC inactivity timer (Ti) parameter specified on the Modify Logical Link Control (LLC) Characteristics parameter when HPR is supported.
Parameter Reply timer override for HPR (HPR T1) Valid Values 1 to 254 seconds Default Value Default value is taken from the associated port parameter. Description This parameter specifies the HPR override LLC reply timer (HPR T1) that is to be used when HPR is supported by this link station. This parameter overrides the value taken from the default reply timer override for HPR parameter specified on HPR Defaults. This parameter supersedes the value of the LLC reply timer (T1) parameter specified on the Modify Logical Link Control (LLC) Characteristics parameter when HPR is supported.
Parameter Maximum number retransmission (HPR N2) Valid Values 1 to 216 000 Default Value Default value is taken from the associated port parameter. Description This parameter specifies the HPR override LLC maximum number of retransmissions (HPR N2) that is to be used when HPR is supported by this link station. This parameter overrides the value taken from the default maximum number of retransmissions for HPR parameter specified on the HPR LLC Override defaults. This parameter supersedes the value of the LLC maximum number of retransmissions (N2) parameter specified on the Modify Logical Link Control (LLC) Characteristics parameter when HPR is supported.
Parameter Limited Resource Timer Valid Values 1 to 216 000 seconds Default Value Default value is taken from the associated port parameter. Description This parameter specifies the timer value associated with the limited resource.

Syntax:

add

lu-name

You will be prompted to enter a station name to associate this LU with.

You will be prompted to enter a value for the following parameter. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 28. Configuration Parameter List - LEN End Node LU Name

Parameter Information

Parameter fully-qualified LU name Valid Values fully-qualified (explicit) LU name Generic (partially explicit) LU name Wildcard entry A string of up to 17 characters in the form of netID.LUname, where: netID is a network ID from 1 to 8 characters LUname is a control point name from 1 to 8 characters Each name must conform to the following rules: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing fully-qualified LU name, using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new LU names. To reduce the number of fully-qualified LU names you need to specify, you can define a generic LU name using the wildcard character (*) to represent a portion of the LU name (LUname). You can also define a wildcard entry by using the wildcard character as the whole LU name. Default Value None Description This parameter specifies the fully-qualified names of LUs associated with a LEN end node. The specified LU names are registered in the network node's directory services database. If a name is not registered, the network node cannot locate the LU (unless the LU name is the same as the CP name of the LEN end node). You need to specify a fully-qualified LU name, which consists of a network ID and the LU name. The network ID is the name of the network that contains the adjacent LEN end node. The LU name is the name of a logical unit accessible through the adjacent LEN end node.

Syntax:

add

connection-network

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 29. Configuration Parameter List - Connection Network - Detail

Parameter Information
Parameter Fully-qualified Connection network name (required for each connection network defined) Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing connection network of which this node desires to become a member, named using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new connection network names. Default Value None Description This parameter specifies the fully-qualified name of the connection network being defined on this router network node. Since this name becomes the CP name of the virtual routing node (VRN), the name must be unique among all CP and LU names in the APPN network (same as in the local Control Point Name). All nodes that are members of a given connection network must use the same VRN Name. The fully-qualified VRN Name (CP name of VRN) has the form: NetworkID.ConnectionNetworkName where NetworkID is this router network node's network identifier.
Parameter Port type (required) Valid Values Token-ring, Ethernet, Frame Relay BAN, IP Note: If the port type is IP, no port name will be specified since there is only one IP port. Default Value None Description This parameter specifies the type of ports providing connectivity to the SATF for the connection network being defined. A given connection network only supports one type of port with one set of characteristics.
Parameter Port name (required) Valid Values Name of port on which APPN routing has been enabled. Note: If the port type is IP, no port name will be specified since there is only one IP port. Default Value None Description This parameter specifies the name of a port providing connectivity to the shared access transport facility (SATF) for the connection network being defined. All ports defined for a given connection network must be the same type and have the same characteristics. Note: For a port type of IP, additional ports added to an IP connection network can be any port that IP has been defined to use. At least one additional port besides the IP port must be added for the connection network to be used. Since the IP port is a pseudo port that always comes up when the node is initialized, real ports that IP is defined on (TR, FR, ...) must be added to the CN. When at least one of these real ports is up, the connection network link is assumed active. When all of these real ports is down, the connection network link is assumed to be inactive.
Parameter Limited Resource Timer Valid Values 1 to 216 000 seconds Default Value 180 Description This parameter specifies the timer value associated with a limited resource.
Parameter DLCI number Valid Values 16 to 1007 Default Value None Description This parameter specifies the DLCI number used by the router to connect to the Frame Relay network. When the router initiates a connection to a link station on the LAN through the connection network, it will use this DLCI number to connect to the Frame Relay network.
Parameter BAN destination address (BDA) Valid Values X'0000 0000 0000' to X'7FFF FFFF FFFF' Default Value X'0000 0000 0000' Description This parameter specifies the BAN destination address configured in the node that is performing the BAN function. If you are using bridging to connect the LAN network to the Frame Relay network, specify X'0000 0000 0000' as the value of this parameter. In this case, the MAC address reported to the APPN topology for the connection network TG is the BNI MAC address coded on the APPN port associated with this connection network definition.

Table 30. Configuration Parameter List - TG Characteristics (Connection Network)

Parameter Information
Parameter Cost per connect time Valid Values 0 to 255 Default Value 0 Description This parameter expresses the relative cost of maintaining a connection over the associated TG. The units are user-defined and are typically based on the applicable tariffs of the transmission facility being used. The assigned values should reflect the actual expense of maintaining a connection over the TG relative to all other TGs in the network. A value of zero means that connections over the TG may be made at no additional cost (as in the case of many non-switched facilities). Higher values represent higher costs.
Parameter Cost per byte Valid Values 0 to 255 Default Value 0 Description This parameter expresses the relative cost of transmitting a byte over the associated TG. The units are user-defined and the assigned value should reflect the actual expenses incurred for transmitting over the TG relative to all other TGs in the network. A value of zero means that bytes may be transmitted over the TG at no additional cost. Higher values represent higher costs.
Parameter Security Valid Values Nonsecure - all else (for example, satellite-connected, or located in a nonsecure country). Public switched network - secure in the sense that route is not predetermined. Underground cable - located in secure country (as determined by the network administrator). Secure conduit - not guarded, (for example, pressurized pipe). Guarded conduit - protected against physical tapping. Encrypted - link-level encryption is provided. Guarded radiation - guarded conduit containing the transmission medium; protected against physical and radiation tapping. Default Value Nonsecure Description This parameter indicates the level of security protection associated with the TG. If security attributes other than the architecturally-defined ones are needed, one of the user-defined TG characteristics may be used to specify additional values.
Parameter Propagation delay Valid Values Minimum LAN - less than 480 microseconds Telephone - between .48 and 49.152 milliseconds Packet switched - between 49.152 and 245.76 milliseconds Satellite - greater than 245.76 milliseconds Maximum Default Value LAN Description This parameter specifies the approximate range for the length of time that it takes for a signal to propagate from one end of the TG to the other.
Parameter Effective capacity Valid Values 2 hexadecimal digits in the range X'00' to X'FF' Default Value X'75' Description This parameter specifies the effective maximum bit transmission rate for this connection network TG. Effective capacity specifies the maximum effective rate for both physical links and logical links. The effective capacity is encoded as a single-byte representation. The values X'00' and X'FF' are special cases used to denote minimum and maximum capacities. The range of the encoding is very large; however, only 256 values in the range may be specified.
Parameter First user-defined characteristic Valid Values 0 to 255 Default Value 128 Description This parameter specifies the first of three additional characteristics that users may define to describe the TGs in the network. The default value of 128 allows a subset of TGs to be defined as more or less desirable than the rest without defining values for all TGs.
Parameter Second user-defined characteristic Valid Values 0 to 255 Default Value 128 Description This parameter specifies the second of three additional characteristics that users may define to describe the TGs in the network. The default value of 128 allows a subset of TGs to be defined as more or less desirable than the rest without defining values for all TGs.
Parameter Third user-defined characteristic Valid Values 0 to 255 Default Value 128 Description This parameter specifies the third of three additional characteristics that users may define to describe the TGs in the network. The default value of 128 allows a subset of TGs to be defined as more or less desirable than the rest without defining values for all TGs.

Syntax:

add

mode

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 31. Configuration Parameter List - APPN COS - Mode Name to COS Name Mapping - Detail

Parameter Information
Parameter Mode name (required) Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing mode name for an existing network, of which this router network node is to become a member, using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new mode names. Default Value None Description This parameter specifies the Mode name for the Mode name to COS name mapping being defined. See "CoS Options" for additional information about Mode name to COS mapping.
Parameter COS name (required) Valid Values The name of a previously defined COS definition, selected from the list of COS names defined for this router network node. Default Value None Description This parameter specifies the COS Name to be associated with the Mode name being defined for this mode name to COS name mapping.
Parameter Session-level pacing Command Line option size Valid Values 1 to 63 Default Value 7 Description This parameter specifies the session-level pacing Command Line option size. This parameter has different definitions depending upon the type of pacing used: For fixed session-level pacing: The session-level pacing Command Line option size parameter specifies the receive pacing Command Line option for this node. The value of this parameter is the suggested receive pacing Command Line option for the adjacent node. For adaptive session-level pacing: The session-level pacing Command Line option size parameter specifies a tuning parameter to be used as the minimum size for Isolated Pacing Messages sent by the adjacent nodes.

Syntax:

add

additional-port-to-connection-network

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Note:

You can have a maximum of 5 ports per connection network definition.

Table 32. Configuration Parameter List - APPN Additional port to Connection Network

Parameter Information
Parameter Connection network name (fully-qualified) (required for each connection network defined) Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Note: An existing connection network of which this node desires to become a member, named using the special characters @, $, and # from the character set A, continues to be supported; however, these characters should not be used for new connection network names. Default Value None Description This parameter specifies the name of the connection network being defined on this router network node. Since this name becomes the CP name of the virtual routing node (VRN), the name must be unique among all CP and LU names in the APPN network (same as in the local Control Point Name). All nodes that are members of a given connection network must use the same VRN Name. The fully-qualified VRN Name (CP name of VRN) has the form: NetworkID.ConnectionNetworkName where NetworkID is this router network node's network identifier.
Parameter Port name Valid Values A unique unqualified name that is automatically generated by the Command Line. The name will consist of: TR (token-ring) EN (Ethernet) Default Value Unqualified name generated by the Command Line. Description This parameter specifies the name representing this port. When the connection network that the port is being added to is IP, only ports that IP is defined to have an interface on will be permitted to be added to the IP CN. At least one real port that has IP defined must be added to the IP CN for the CN to become active and to be used.

Syntax:

add

focal_point

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 33. Configuration Parameter List - APPN Implicit Focal Point

Parameter Information

Parameter focal point Valid Values A fully-qualified CP name Default Value Blanks Description This parameter specifies the fully-qualified CP name representing this focal point. The first focal point added is the primary implicit focal point. Up to 8 additional backup implicit focal points may be added by invoking Add focal_point multiple times. If the primary implicit focal point is taken off the focal point list with Delete focal_point, the first backup implicit focal point, if there is one, becomes the primary implicit focal point.

Syntax:

add

local-pu

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 34. Configuration Parameter List - APPN Local PU

Parameter Information
Parameter Station name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name representing the link between the DLUR and the PU.
Parameter Primary DLUS name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name to be used to override the primary DLUS configured for this node.
Parameter Secondary DLUS name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name to be used to override the secondary DLUS configured for this node.
Parameter Autoactivate Valid Values Yes or No Default Value Yes Description This parameter specifies whether to activate this link at start-up. Note: If the local link will be used for a DDDLU PU, you should specify yes to this question. If the local link is not set to autoactivate, then the first attempt to use the local pu (that is, the first attempt to establish a TN3270 session) will fail because the link is not yet up. While this attempt will fail, it causes the link to come up, and that link will be available for the next attempt. Since the link comes up when the SSCP-PU session is established, and that is when the link is identified as a DDDLU link. No DDDLU sessions can be established until the link is identified as a DDDLU link.
Parameter Enable Host Initiated Dynamic LU Definition Valid Values Yes or No Default Value No Description This parameter indicates whether or not dependent LUs will be created dynamically (as opposed to having to be configured.) If yes is specified, LUs will be defined for this PU as ACTLU requests (with CV0E) are received. LUs for the TN3270E Server do not have to be configured.
Parameter Pool Name for Host-initiated Dynamic LUs Valid Values A string of 1 to 8 characters: First character: A to Z, $, #, @, or < Second to eighth characters: A to Z, 0 to 9, $, #, @, >, or < Default Value None Description This parameter specifies the name of a pool to be created to contain LUs that the host activates on this local PU. This parameter is applicable only if Enable Host Initiated Dynamic LU Definition is yes. You do not need to use the add implicit-pool command to define this pool; specifying the name and other parameters here is sufficient to cause the pool to be created. If you do enter a pool name, you will be prompted to enter values for the following parameters: Pool class (See Table 39) LU type (see Table 39) You can provide the same pool name for multiple local PUs, if you wish. By specifying pool information, you cause host-initiated LUs that are not already configured at the router to be placed into the specified pool. TN3270 clients can then be assigned to them by requesting the pool name, or by mapping client IP addresses or destination ports to that pool. If you do not specify pool information, these host-initiated LUs are treated as explicit LUs and can only be assigned to clients that request them by their individual LU names.
Parameter Send Terminate-Self when TN3270 Client Disconnects Valid Values Yes or No Default Value No Description This parameter indicates whether or not a terminate_self request will be sent to the SSCP when the TN3270 client disconnects. If yes is specified, terminate_self will be sent and the host will be responsible for terminating the LU-LU session (i.e., the SLU will NOT send an UNBIND request.)

Syntax:

add

routing_list

Note:

These questions are asked only if you have configured the node as a border node.

There are a number of editing shortcut keys available to speed the modification of existing data in a previously configured routing list. These shortcut keys may be used when you are prompted for the Destination LUs and the Routing CPs.

• Pressing Enter alone will retain the currently displayed name.
• Pressing the Space bar followed by Enter will delete the currently displayed name.
• Entering character data followed by pressing Enter will replace the currently displayed name with the new character data.
• Entering 9 followed by pressing Enter will jump to the end of the list where new names can be appended.
• At the end of a list, pressing Enter alone completes the list.

Table 35. Configuration Parameter List - Routing List Configuration

Parameter Information
Parameter Routing list name Valid Values Character string up to 20 characters in length with no imbedded blanks. Mixed case and special characters are allowed. Default Value Blank Description This parameter identifies a specific routing list for modification. listing, or deletion by the configuration code. It is not used by the operational code. Up to 255 routing lists may be configured depending upon availability of configuration memory. Case is respected.
Parameter Subnet visit count Valid Values 1 to 255 Default Value Default taken from corresponding node level parameter Description This parameter specifies how many networks a locate search procedure may traverse.
Parameter Dynamic routing list updates Valid Values 0 (none) 1 (full) 2 (limited) Default Value Default value taken from corresponding node level parameter Description This parameter controls whether entries can be automatically added to the node's temporary subnet routing list. It can be set to the same values as the analogous node level parameter. If this function is enabled the automatically added entries are only added to the temporary copy of the routing list.
Parameter Enable routing list optimization Valid Values Yes or No Default Value Yes Description Indicates whether the node is allowed to reorder the subnetwork routing list so that entries most likely to succeed come first. This reordering occurs in the internal temporary copy of the routing list.
Parameter Destination LU found via this list Valid Values A fully-qualified LU name with optional trailing wildcard. Legal characters for the LU name are: A-Z, @, $, #, 0-9. The first character of the NETID part and of the LU name part must be non-numeric. Any of the FQ LU names may be terminated with a wild card "*" character to designate the range of LUs. For example, * NETI* NETI.LUA* Default Value Blank Description This parameter specifies a list of destination LUs that can be found via this routing list. This question will be repeated until terminated with a null entry. Notes: Only a single entry among all of the routing lists may have a standalone "*" . This will match all LUs, and the routing list containing it is known as the default routing list. All the editing shortcuts described at the beginning of this table are available to speed modification of a previously configured routing CP(s) list. Any given LU name may not be duplicated in another routing list. Maximum number of LU names that may be specified: 2212 - 126
Parameter Routing CP and optional subnet visit count Valid Values A fully-qualified CP name consisting of 1 to 17 characters followed by an optional numeric subnet visit count. Legal characters for the CP name are: A-Z, @, $, #, 0-9 The first character of the NETID part and of the CP name part must be non-numeric. The optional subnet visit count range is 1 to 255 and should be separated from the fully-qualified CP name by one or more spaces. Default Value Blank for fully-qualified CP name and node-level setting for subnet visit count. Description This parameter specifies a list of one or more fully-qualified CP names of CPs that might know how to reach one or more of the previously configured destination LUs. Each of the following special keywords may be used once in any given routing list: "*" - equivalent to specifying all native BNs, all adjacent non-native BNs, and all adjacent non-native NNs. "*SELF" - equivalent to specifying the local node's fully-qualified CP name "*EBNS" - equivalent to specifying all native BNs This question will be repeated until terminated with a null entry. Notes: All the editing shortcuts described at the beginning of this table are available to speed modification of a previously configured routing CP list. If you configure "*SELF" as a CP name, you cannot configure the local node's CP name. Any given routing list can have the following maximum number of CP names and keywords: 2212 - 144 Across all routing lists, you may use no more than the following number of different CP names and keywords: 2212 - 144 Any given CP name or keyword may appear in no more than 255 routing lists.

Syntax:

add

cos_mapping_table

Note:

These questions are asked only if you have configured the node as a border node. The editing shortcut keys specified at the beginning of the routing list table are also valid here. Use them to speed modification of the non-native CP names and COS name pairs.

Table 36. Configuration Parameter List - COS Mapping Table Configuration

Parameter Information
Parameter COS mapping table name Valid Values Character string up to 20 characters in length, with no imbedded blanks. Mixed case and special characters are allowed. Default Value Blank Description This parameter identifies a specific COS mapping table. It allows you to identify the table for modification, listing, or deletion by the configuration software. It is not used by the operational software. Up to 255 COS mapping tables may be configured depending upon availability of configuration memory. Case is respected.
Parameter Non-native NETID or CP name Valid Values A fully-qualified CP name with optional trailing wildcard. Legal characters for the CP name are: A-Z, @, $, #, 0-9 The first character of the NETID part and of the CP name part must be non-numeric. Any of the fully-qualified CP names may be terminated with a wildcard "*" character to designate a range of CPs. For example: * NET1* NET1.LUA* Default Value Blank Description This parameter specifies a list of one or more non-native networks that this mapping table applies to. This question is repeated until terminated with a null entry. Notes: Only a single entry among all the routing lists may have a standalone "*" . This will match all non-native networks, and is known as the default routing list. Any given CP name may not be duplicated in another COS mapping table. Maximum number of CP names that may be specified: 2212 - 126
Parameter Native and non-native COS-name pair Valid Values A pair of COS names, separated by a blank. Legal characters are: A-Z, @, $, #, 0-9 The first character of each name must be non-numeric. Default Value Blank Description This parameter identifies a pair of COS names. A native COS name is followed by the corresponding non-native COS name. For any given COS mapping table, one of the COS name pairs may specify the non-native COS name as "*" . This designates the default entry to use for all non-native COS names that do not explicitly match another entry in the table. One COS name pair cannot exactly match another COS name pair in a given table. However, a given native COS name can be used in multiple entries, and it is also okay for a given non-native COS name to be used in multiple entries. The operational software will use the first entry it finds. This question will be repeated until terminated with a null entry. Notes: The native and non-native names cannot be identical. Only COS names that need to be changed should be specified. A given native or non-native COS name may appear in multiple entries, but you cannot have two identical COS name pairs. When you have multiple native COS names mapping to the same non-native COS name, the border node will use the first of those mappings when it needs to map from non-native to native. Similarly, when you have multiple non-native COS names mapping to a common native COS name, the border node will use the first of those mappings when it needs to map from native to non-native. Any given COS mapping table can have the following maximum number of COS name pairs: 2212 - 46 Across all COS mapping tables, you may use no more than the following number of native COS names: 2212 - 144 There is no analogous limit for non-native COS names. Any given native COS name may appear no more than 255 times across all routing lists.

Delete

Use the delete command to delete:

Syntax:

delete

port port-name

link link-station-name

lu-name lu-name

connection-network connection-network-name

additional-port-to-connection-network cn-port-name

mode name

focal_point focal-point-name

local-pu

routing_list routing list name

cos_mapping_table mapping table name

List

Use the list command to list:

Syntax:

list

all

node

traces

management

hpr

dlur

port (port name)

link station (link station name)

lu name lu name

mode name mode name

connection network connection network name

focal_point

routing_list routing list name

cos_mapping_table mapping table name

Activate_new_config

Use the activate_new_config command to read the configuration into non-volatile memory.

Syntax:

activate_new_config

TN3270E

Table 37. TN3270E Configuration Command Summary

Command	Function	See page:
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Set	tn3270e	***
Add	Adds or updates the following:
	implicit-pool	Table 39
	lu	Table 40
	mapping	***
	port	***
Delete	Deletes the following:  implicit-pool lu mapping port	***
List all	Lists the configuration memory	***
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

Syntax:

set

You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 38. Configuration Parameter List - Set TN3270E

Parameter Information
Parameter Enable TN3270E Server Valid Values Yes or No Default Value Yes Description This parameter specifies whether TN3270E Server support will be enabled.
Parameter TN3270E Server IP Address Valid values Any IP address is accepted as valid input. However, the address must also be configured in IP either as an interface address or as the router's internal IP address. Default Value None Description This parameter is the IP address associated with the TN3270E Server.
Parameter Port number Valid Values 1 to 65 535 Default Value 23 Description This parameter specifies the port number associated with the TN3270E Server.
Parameter Enable Client IP address to LU name mapping? Valid values Yes or No Default Value No Description This parameter specifies whether client IP address to LU name mapping occurs.
Parameter Default pool name Valid Values Any alphanumeric string of 1 to 8 characters Default Value PUBLIC Description This parameter specifies the name of the default pool. This pool is used when TN3270 clients connect and do not specify an LU/pool name.
Parameter NetDisp Advisor Port Number Valid Values 1 to 65 535 Default Value 10 008 Description This parameter sets the port number for the Network Dispatcher Advisor.
Parameter Keepalive type Valid Values 0 None 1 Timing mark 2 NOP Default Value 0 Description This parameter specifies the Keepalive type. A Keepalive type of Timing mark requires responses from the client within the amount of time specified using the Timer parameter. A Keepalive type of NOP specifies that the client will not send back a response to the Keepalive message. Notification that the client is no longer there will come from TCP.
Parameter Frequency Valid Values 1 to 65 535 seconds Default Value 60 Description This parameter specifies how often the Keepalive message is sent to the client.
Parameter Timer Valid Values 1 to 65535 seconds Default Value 10 Description This parameter sets the timer value to be used with the Keepalive function.
Parameter Automatic logoff Valid Values Yes or No Default Value No Description This parameter specifies whether automatic logoff will be enabled.
Parameter Time Valid Values 1 to 65 535 minutes Default Value 30 Description This parameter sets the time that the TN3270E link can be idle before being automatically logged off.
Parameter IPv4 Precedence Valid Values Yes or No Default Value No Description This parameter sets the IPv4 precedence value, which allows priority queueing of IPv4 encapsulated packets.
Parameter Enable LU Capping? Valid Values Yes or No Default Value No Description This parameter allows you to determine how many TN3270 sessions each IP address is allowed to initiate. If the answer to this question is yes, you will be asked the following question.
Parameter Max number of LUs per IP address Valid Values 0 - 65 535 Default Value 0 Description This parameter sets the maximum number of TN3270 sessions each client IP address is allowed to initiate.

Syntax:

add

implicit-pool

This command defines a pool of LUs as opposed to the add lu command which adds a single LU. You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 39. Configuration Parameter List - Add TN3270E Implicit

Parameter Information
Parameter Pool name Valid Values A string of 1 to 8 characters: First character: A to Z, $, #, @, or < Second to eighth characters: A to Z, 0 to 9, $, #, @, > or < Default Value PUBLIC Description This parameter specifies the name of the LU pool to be used when TN3270 clients connect.
Parameter Pool class Valid Values 1 or 2, where: Implicit workstation Implicit printer Default Value 1 Description This parameter specifies type of LU pool.
Parameter Station name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name representing the link between the DLUR and the PU or the subarea link over which SNA data will flow.
Parameter LU Name Mask Valid Values A string of 1 to 5 characters: First character: A to Z, @, $, and # Second to eighth characters: A to Z, 0 to 9 Default Value @01LU Description This parameter specifies the mask to be used to ensure that the LU names will not duplicate other names in the network. LU names are generated by appending the NAU address to the end of the LU name mask. When not specifying an address range, NAU addresses from 2 - 253 will be checked to see if the address is unused. If the address is available, it will be used. Otherwise, the next NAU address will be tried. For example, if the LU name mask is FRED, the possible LU names are [FRED2, FRED3, ..., FRED253].
Parameter LU type Valid Values 1 - 3270 Mod 2 display 2 - 3270 Mod 3 display 3 - 3270 Mod 4 display 4 - 3270 Mod 5 display 5 - 3270 printer 6 - SCS printer Default Value 1 Description This parameter specifies the type of dependent LU for the LU being added.
Parameter Specify LU address range? Valid Values Yes or No Default Value No Description This parameter specifies whether you want to define an LU address range.
Parameter LU address range Valid Values Any range of values within 1 - 255 Default Value none Description This parameter specifies LU address range. The LU address range can be specified by using the following format: lower_address_bound-upper_address_bound If no hyphen follows the first value, that value is assumed to be a single LU address. Multiple ranges can be entered, separated by commas. For example, the following string specifies 2 address ranges and 2 specific LU addresses: 2-40,56,58,100-250
Parameter Number of implicit workstation definitions Valid Values 1 to 255 Default Value 1 Description This parameter specifies the number of dependent LUs to be added to the implicit pool.

add

lu

This command adds a specific LU. You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 40. Configuration Parameter List - Add TN3270E LU

Parameter Information
Parameter LU name Valid Values A string of 1 to 8 characters: First character: A to Z,@, $, and # Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the LU name of the dependent LU being defined.
Parameter NAU address Valid Values 1 to 255 Default Value None Description This parameter specifies the NAU address of the LU being defined.
Parameter Station name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name representing either the link between the DLUR and the PU defined using the add local-pu command or the subarea link over which SNA data will flow.
Parameter Class Valid Values 1 Explicit Workstation 2 Implicit Workstation 3 Explicit Printer 4 Implicit Printer Default Value 1 Description This parameter specifies the LU class.
Parameter LU type Valid Values 1 -- 3270 Mod 2 display 2-- 3270 Mod 3 display 3 -- 3270 Mod 4 display 4 -- 3270 Mod 5 display 5 -- 3270 printer 6 -- SCS printer Default Value 1 Description This parameter specifies the type of dependent LU for the LU being added.
Parameter Implicit pool name Valid Values A string of 1 to 8 characters: First character: A to Z, < Second to eighth characters: A to Z, 0 to 9 Default Value <DEFLT> Description This parameter specifies the name of the implicit pool to be used in the LU definition. This question is asked only if the class is an implicit workstation or implicit printer.
Parameter Define an associated printer Valid Values Yes or No Default Value No Description This parameter specifies whether you want to define an associated printer.
Parameter Associated printer name Valid Values A string of 1 to 8 characters: First character: A to Z,@, $, and # Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name of the associated printer.
Parameter Associated printer NAU address Valid Values 1 to 255 Default Value None Description This parameter specifies the NAU address for the associated printer LU definition.

Syntax:

add

map

This command adds a client IP address to LU name mapping. You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

The following mapping rules apply:

• If a map definition contains a full subnet mask (255.255.255.255), indicating that the entry is for a specific client and a specific LU/pool is not requested by the client, any LU/pool in the map definition that matches the connection type may be tried.
• If a map definition does not contain a full subnet mask and a specific LU/pool is not requested, only pool entries in the map definition will be tried. You cannot create a definition that maps a subnet to a specific LU. You must map the subnet to a pool.
• If a connection request is received from a client and there are no map entries that match, the request will be rejected.
• A mixture of pool and LU types can be added to a particular map. The resource selected will be based on the type of connection request. The order in which the resources are defined in the map will be the order in which it is chosen for a particular connection request.
• If a map definition contains a non-zero destination port number, only clients that connect to that port will be checked against that mapping.

Note:

When a client connects while mapping is enabled, the server will begin ANDing the client's IP address with the subnet mask of each sequential map. The longest match between the incoming client IP address and the map definition determines which map definition is tried first. If all eligible resources in the map definition are in use and final LU mapping connection attempt is no, the map definitions are again searched for the next most specific match.

Table 41. Configuration Parameter List - Add TN3270E Map

Parameter Information
Parameter Pool name/LU name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies an LU name or a Pool name to be mapped to the IP address. The LU name can only be mapped to a Host address. If the mask is a network mask, the name specified must be a pool name.
Parameter Client IP address or Network address Valid Values Any valid IP address Default Value 0.0.0.0 Description This parameter specifies the IP address of the client or network map definition to be added.
Parameter Address Mask Valid Values Any valid IP address mask Default Value 0.0.0.0 Description This parameter specifies the IP address mask the router applies to incoming client IP addresses and configured client IP or network addresses to determine whether they match.
Parameter Port number Valid Values 1 to 65535 If you want to specify a particular port, you should select either the global TN3270 server port value defined with the set command, or one of the port values defined with the add port command. Default Value 0 Description This parameter specifies the destination TCP port number a TN3270 client must connect to in order for this mapping entry to be checked. If the value is zero, the mapping entry applies to client connections to any defined TCP port number.
Parameter Final LU mapping connection attempt Valid Values Yes or No Default Value No Description This parameter specifies whether the router should continue to try less specific mapping entries if a client match with this entry failed to yield a valid available LU.

Syntax:

add

port

This command specifies additional port for the TN3270E Server to listen on. You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 42. Configuration Parameter List - Add TN3270E Port

Parameter Information
Parameter Port number Valid Values 1 to 65535 Default Value none Description This parameter specifies the port number to be added.
Parameter Support TN3270E? Valid Values Yes or No Default Value Yes Description This parameter specifies whether the added port will negotiate to be a TN3270E server. If it is not an "E" Server, it will not support printing or system requests.
Parameter Pool name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name of the pool associated with this port. Clients that connect to this port and do not specify an LU name or pool name will be assigned an LU from this pool.
Parameter Disable Client Filtering for this port? Valid Values Yes or No Default Value No Description This parameter specifies whether incoming connections on this port should use the box-wide Client IP Address to LU Name Mapping function if it is enabled.

Syntax:

delete

lu

This command removes a TN3270E LU. You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 43. Configuration Parameter List - Delete TN3270E LU

Parameter Information
Parameter LU name Valid Values A string of 1 to 8 characters: First character: A to Z,@, $, and # Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the LU name of the dependent LU to be removed.

Syntax:

delete

implicit-pool

This command removes a TN3270E implicit pool. You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 44. Configuration Parameter List - Delete TN3270E Implicit

Parameter Information
Parameter Pool name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name of the LU pool to be deleted.
Parameter Delete entire pool Valid Values Yes or No Default Value No Description This parameter specifies whether the entire pool or a specific entry is to be deleted.
Parameter Station name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the name of the station to be deleted.

Syntax:

delete

map

This command removes a client IP address to LU name mapping. You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 45. Configuration Parameter List - Delete TN3270E Map

Parameter Information
Parameter Client IP address or Network address Valid Values Any valid IP address Default Value 0.0.0.0 Description This parameter specifies the IP address of the client or network map definition to be deleted.
Parameter Client IP address or Network address Mask Valid Values Any valid IP address mask Default Value 0.0.0.0 Description This parameter specifies the IP address mask of the client or network map definition to be deleted.
Parameter Delete all entries for this client? Valid Values Yes or No Default Value No Description This parameter specifies whether the entire pool or a specific name is to be deleted.
Parameter Pool name Valid Values A string of 1 to 8 characters: First character: A to Z Second to eighth characters: A to Z, 0 to 9 Default Value None Description This parameter specifies the LU name or pool name to be deleted.

Syntax:

delete

port

This command deletes port definitions. You will be prompted to enter values for the following parameters. The parameter range will be shown in parentheses ( ). The parameter default will be shown in square brackets [ ].

Table 46. Configuration Parameter List - Delete TN3270E Port

Parameter Information
Parameter Port number Valid Values 1 to 65536 Default Value none Description This parameter specifies the port number to be added.

Syntax:

list

all

This command lists a TN3270E configuration.

Monitoring APPN

This section describes how to monitor APPN. It includes the following sections:

• Accessing the APPN Monitoring Commands
• APPN Monitoring Commands

Accessing the APPN Monitoring Commands

Use the following procedure to access the APPN monitoring commands. This process gives you access to an APPN's monitoring process.

At the OPCON prompt, enter talk 5.

After you enter the talk 5 command, the GWCON prompt (+) displays on the terminal. If the prompt does not appear when you first enter configuration, press Return again.

Enter protocol APPN For example:

* talk 5
+
+ protocol APPN
APPN> 

If typing p appn results in the message "Protocol APPN is available but not configured", you probably have one of the following errors:

• You have not enabled APPN globally in the active configuration (although you may have configured APPN parameters). Check the current configuration and if this is the case, enable APPN and restart or reload the router.
• The amount of memory required for APPN to initialize properly was not available in the router. Use talk 2 to see if an error message to this effect has been logged. If so, reconfigure APPN to use less memory and restart or reload the router.

Once you have reached the APPN monitoring prompt, enter tn3270 to reach the TN3270E > monitoring prompt.

APPN Monitoring Commands

This section describes the APPN monitoring commands for monitoring APPN interfaces. Enter the commands at the APPN> prompt, and TN3270 server commands at the TN3270E> prompt.

Table 47. APPN Monitoring Command Summary

Command	Function	See details on page:
? (Help)	Displays all the commands available for this command level or lists keyword options for specific commands.	--
activate link	Activates a configured link.	"Activate"
aping	Tests SNA/APPN connectivity to a target LU.	"Aping"
deactivate link	Deactivates a configured or dynamic link.	"Deactivate link"
dump	Writes an APPN dump to disk or to the network.	"Dump"
list cp-cp_sessions	Displays a list of all adjacent CPs that may have CP-CP sessions with this router.	page ***
list dlur dlus	Displays a list of active DLUS's and the status of each session in the DLUS-DLUR pipe.	page ***
list dlur lu	Displays a list of downstream or internal PUs with LU statistics for each PU.	page ***
list dlur pu	Displays a list of downstream or internal PUs with their connection status.	page ***
list dlur status	Displays a summary of currently active global DLUR configuration information.	page ***
list ds incomplete_locates	Displays a list of APPN searches that are currently in progress.	page ***
list ds resource	Displays a complete or partial list of LU names in this router's APPN directory.	page ***
list ds status	Displays summary statistics for APPN Directory Services.	page ***
list dumps	Displays a list of dumps on disk.	page ***
list focal	Displays a list of network management focal points with their status.	page ***
list isr_sessions	Displays the number of active ISR LU-LU sessions that pass through this router, by link.	page ***
list link	Displays a list of configured and dynamic links from this router.	page ***
list link link-name	Displays detailed configuration and status about one particular link.	page ***
list local_link	Displays a list of logical links from DLUR to local PU2.0s in this router (which are used to contain TN3270 LUs).	page ***
list log	Now replaced by "log view" and "log status".	page ***
list port	Displays a list of configured physical and logical APPN router ports with their status.	page ***
list port port-name	Displays detailed configuration and status about one particular port.	page ***
list rtp	Displays a list of nodes in the RTP Partner Table, and summary information about all active RTP connections.	page ***
list rtp tcid	Displays detailed information about one or all RTP connection(s).	page ***
list session	Displays a list of ISR sessions that flow through the router.	page ***
list status	Displays a summary of general APPN configuration and status information.	page ***
list topo node	Displays information in this router's topology database about a particular node in this topology subnet.	page ***
list topo status	Displays a summary of topology database statistics.	page ***
list topo tg	Displays a complete or partial list of active TGs in this topology subnet.	page ***
log status	Displays summary information about the APPN event log.	page ***
log view	Enters a submenu for navigating and viewing APPN event log entries.	page ***
memory	Displays summary and detailed information about APPN memory usage within the router.	"Memory"
restart	Stops and reactivates APPN and TN3270 disruptively.	"Restart"
rtp status	Displays currently in-use global RTP configuration information.	"Rtp status"
rtp switchpath	Causes an RTP connection to path switch to the best currently available path.	"Rtp switchpath"
rtp test	Does an HPR route test and displays the results.	"Rtp test"
stop	Stops APPN and TN3270 disruptively.	"Stop"
test rtp	Does an HPR route test and display the results (old form of "rtp test").	"Rtp test"
tn3270e	Accesses the TN3270 monitoring command menu.	"TN3270E Monitoring Commands"
transmit dump	Transmits an APPN dump from the router's hard disk (2216, Network Utility, 2212) to a workstation in the network using TFTP.	"Transmit"
exit	Returns you to the main Talk 5 monitoring menu.	--

Table 48. TN3270E Server Monitoring Command Summary

Command	Function	See details on page:
? (Help)	Displays all the commands available for this command level or lists keyword options for specific commands.	--
deactivate lu	Deactivates by force an LU in use by a TN3270 client, and disconnects the corresponding TCP connection to that client.	"Deactivate LU"
list connections	Displays a complete or partial list of active client connections.	***
list lu lu-name	Displays detailed configuration and status information about a single internal LU.	***
list mapping	Displays a list of configured client IP address to LU/pool name mappings.	***
list pools	Displays a list of configured implicit LU pools.	***
list pools pool-name	Displays detailed information about a single LU pool.	***
list ports	Displays a list of configured TN3270 server target TCP ports.	***
list pu	Displays a list of all internal PUs (both DLUR and subarea) with summary status and configuration information.	***
list pu pu-name	Displays a list of all internal LUs under the specified PU, with summary status and configuration information for each LU.	***
list rejections	Displays a list of the most recent client connections rejected.	***
list status	Displays global TN3270 server configuration and statistical summary.	***
exit	Returns you to the APPN monitoring menu.	--